WebGPU API
The uncapturederror event of the GPUDevice interface is fired when an error is thrown that has not been observed by a GPU error scope, to provide a way to report unexpected errors.
Known error cases should be handled using GPUDevice.pushErrorScope and GPUDevice.popErrorScope.
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("uncapturederror", (event) => { })
Alternatively, assign to the event handler property of the interface:
onuncapturederror = (event) => { }
Event type
A GPUUncapturedErrorEvent. Inherits from Event.
GPUUncapturedErrorEvent
Examples
You could use something like the following as a global mechanism to pick up any errors that aren't handled by error scopes and capture them.
device.addEventListener("uncapturederror", (event) => {
// Re-surface the error.
console.error("A WebGPU error was not captured:", event.error);
reportErrorToServer({
type: event.error.constructor.name,
message: event.error.message,
});
});
See WebGPU Error Handling best practices for more examples and information.
Specifications
Browser compatibility
See also
- The WebGPU API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
