GPUDevice: uncapturederror event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("WebGPU API")}}{{SecureContext_Header}}{{AvailableInWorkers}}
The **uncapturederror** event of the {{domxref("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 {{domxref("GPUDevice.pushErrorScope", "pushErrorScope()")}} and {{domxref("GPUDevice.popErrorScope", "popErrorScope()")}}.
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("uncapturederror", (event) => { })Alternatively, assign to the event handler property of the interface:
onuncapturederror = (event) => { }Event type
A {{domxref("GPUUncapturedErrorEvent")}}. Inherits from {{domxref("Event")}}.
{{InheritanceDiagram("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
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- The WebGPU API