GPUDevice: destroy() method

Secure contextAvailable in workers

The destroy() method of the GPUDevice interface destroys the device, preventing further operations on it.

Note that:

• Any commands currently enqueued on the device’s GPUQueue will be executed before the device is destroyed.
• Any WebGPU resources created using the device (buffers, textures, etc.) are also destroyed.
• Any mapped buffers created using the device will be unmapped.

Syntax

destroy()

Parameters

None.

Return value

None (undefined).

Examples

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.");
  }

  let device = await adapter.requestDevice();

  // Some time later

  device.destroy();
}

Specifications

Browser compatibility

See also

• The WebGPU API