GPUUncapturedErrorEvent

实验性： 这是一个 实验性技术
在生产环境中使用之前，请仔细检查 浏览器兼容性表。

安全上下文：此功能仅在 安全上下文（HTTPS）中可用，在某些或所有 支持的浏览器 中。

GPUUncapturedErrorEvent 是 WebGPU API 的一个接口，它是 GPUDevice 的 uncapturederror 事件的事件对象类型，用于遥测和报告意外错误。

已知的错误情况应使用 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

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅