GPUDevice: uncapturederror event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.

Note: This feature is available inWeb Workers.

Theuncapturederror event of theGPUDevice 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 usingpushErrorScope() andpopErrorScope().

Syntax

Use the event name in methods likeaddEventListener(), or set an event handler property.

addEventListener("uncapturederror", (event) => { })onuncapturederror = (event) => { }

Event type

AGPUUncapturedErrorEvent. Inherits fromEvent.

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,  });});

SeeWebGPU Error Handling best practices for more examples and information.