GPUUncapturedErrorEvent

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

GPUUncapturedErrorEvent 接口是 WebGPU API 中的事件对象类型,用于 GPUDeviceuncapturederror 事件,用于遥测和报告意外错误。

已知错误情况应使用 pushErrorScope()popErrorScope() 进行处理。

Event GPUUncapturedErrorEvent

构造函数

GPUUncapturedErrorEvent()

创建一个新的 GPUUncapturedErrorEvent 对象实例。

实例属性

继承其父级 Event 的属性。

error 只读

一个 GPUError 对象实例,提供对错误详情的访问。

示例

您可以使用类似以下的机制来捕获未被错误范围处理的任何错误。

js
// …

device.addEventListener("uncapturederror", (event) => {
  // Re-surface the error
  console.error("A WebGPU error was not captured:", event.error.message);
  reportErrorToServer({
    type: event.error.constructor.name,
    message: event.error.message,
  });
});

// …

规范

规范
WebGPU
# gpuuncapturederrorevent

浏览器兼容性

另见