/Web APIs

GPUDevice: uncapturederror event

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

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 pushErrorScope() and popErrorScope().


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


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

onuncapturederror = (event) => {};

Event type


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

    type: event.error.constructor.name,
    message: event.error.message,

See WebGPU Error Handling best practices for more examples and information.


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
113Currently supported on ChromeOS, macOS, and Windows only.
113Currently supported on ChromeOS, macOS, and Windows only.
previewCurrently supported on Linux and Windows only.
99Currently supported on ChromeOS, 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.