W3cubDocs

/Web APIs

GPUUncapturedErrorEvent

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The GPUUncapturedErrorEvent interface of the WebGPU API is the event object type for the GPUDevice uncapturederror event, used for telemetry and to report unexpected errors.

Known error cases should be handled using pushErrorScope() and popErrorScope().

Event GPUUncapturedErrorEvent

Constructor

GPUUncapturedErrorEvent() Experimental

Creates a new GPUUncapturedErrorEvent object instance.

Instance properties

Inherits properties from its parent, Event.

error Experimental Read only

A GPUError object instance providing access to the details of the error.

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.message);
  reportErrorToServer({
    type: event.error.constructor.name,
    message: event.error.message,
  });
});

// ...

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
GPUUncapturedErrorEvent
113Currently supported on ChromeOS, macOS, and Windows only.
113Currently supported on EdgeOS, macOS, and Windows only.
previewCurrently supported on Linux and Windows only.
No
NoCurrently supported on OperaOS, macOS, and Windows only.
No No No No No No No
GPUUncapturedErrorEvent
113Currently supported on ChromeOS, macOS, and Windows only.
113Currently supported on EdgeOS, macOS, and Windows only.
previewCurrently supported on Linux and Windows only.
No
NoCurrently supported on OperaOS, macOS, and Windows only.
No No No No No No No
error
113Currently supported on ChromeOS, macOS, and Windows only.
113Currently supported on EdgeOS, macOS, and Windows only.
No No
NoCurrently supported on OperaOS, macOS, and Windows only.
No No No No No No No

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GPUUncapturedErrorEvent