MDN self-hosted library · e01.org

GPU

WebGPU API

WebGPU API

The GPU interface of the WebGPU API is the starting point for using WebGPU. It can be used to return a GPUAdapter from which you can request devices, configure features and limits, and more.

The GPU object for the current context is accessed via the Navigator.gpu or WorkerNavigator.gpu properties.

Instance properties

  • wgslLanguageFeatures
  • : A WGSLLanguageFeatures object that reports the WGSL language extensions supported by the WebGPU implementation.

Instance methods

  • requestAdapter()
  • : Returns a Promise that fulfills with a GPUAdapter object instance. From this you can request a GPUDevice, which is the primary interface for using WebGPU functionality.
  • getPreferredCanvasFormat()
  • : Returns the optimal canvas texture format for displaying 8-bit depth, standard dynamic range content on the current system.

Examples

Requesting an adapter and a device

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

  const device = await adapter.requestDevice();

  // …
}

Configuring a GPUCanvasContext with the optimal texture format

const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

Specifications

Browser compatibility

See also