GPUCanvasContext: getConfiguration() method

Secure contextAvailable in workers

The getConfiguration() method of the GPUCanvasContext interface returns the current configuration set for the context.

Syntax

getConfiguration()

Parameters

None.

Return value

An object containing the configuration options set on the context (i.e., via the configure() method), or null if no configuration is set (either no configuration was previously set, or a configuration was set and then unconfigure() was called on the context).

Examples

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

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

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

console.log(context.getConfiguration());
/* Logs something like:

{
  "alphaMode": "premultiplied",
  "colorSpace": "srgb",
  "device": { ... },
  "format": "bgra8unorm",
  "toneMapping": {
      "mode": "standard"
  },
  "usage": 16,
  "viewFormats": []
}
*/

Specifications

Browser compatibility

See also

• configure()
• The WebGPU API