GPUDeviceLostInfo

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 in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The GPUDeviceLostInfo interface of the WebGPU API represents the object returned when the GPUDevice.lost Promise resolves. This provides information as to why a device has been lost.

See the GPUDevice.lost page for more information about "lost" state.

Instance properties

message Read only

A string providing a human-readable message that explains why the device was lost.

reason Read only

An enumerated value that defines the reason the device was lost in a machine-readable way.

Examples

js
async function init() { if (!navigator.gpu) { throw Error("WebGPU not supported."); } const adapter = await navigator.gpu.requestAdapter(); if (!adapter) { throw Error("Couldn't request WebGPU adapter."); } // Create a GPUDevice let device = await adapter.requestDevice(descriptor); // Use lost to handle lost devices device.lost.then((info) => { console.error(`WebGPU device was lost: ${info.message}`); device = null; if (info.reason !== "destroyed") { init(); } }); // … }

Specifications

Specification
WebGPU
# gpudevicelostinfo

Browser compatibility

See also