GPUDevice: destroy() method

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

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

js
destroy()

Parameters

None.

Return value

None (undefined).

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

  let device = await adapter.requestDevice();

  // Some time later

  device.destroy();
}

Specifications

Specification
WebGPU
# dom-gpudevice-destroy

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
Deno
destroy
Experimental

See also