GPUAdapter

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 GPUAdapter interface of the WebGPU API represents a GPU adapter. From this you can request a GPUDevice, adapter info, features, and limits.

A GPUAdapter object is requested using the GPU.requestAdapter() method.

Instance properties

features Read only: A GPUSupportedFeatures object that describes additional functionality supported by the adapter.
info Read only: A GPUAdapterInfo object containing identifying information about the adapter.
limits Read only: A GPUSupportedLimits object that describes the limits supported by the adapter.

Deprecated properties

isFallbackAdapter Read only Deprecated Non-standard: A boolean value. Returns true if the adapter is a fallback adapter, and false if not. This property has been removed from the web platform. Use GPUAdapterInfo.isFallbackAdapter instead.

Instance methods

requestAdapterInfo() Deprecated Non-standard: Returns a Promise that fulfills with a GPUAdapterInfo object containing identifying information about the adapter.
requestDevice(): Returns a Promise that fulfills with a GPUDevice object, which is the primary interface for communicating with the GPU.

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.");
 }
 const device = await adapter.requestDevice();
 // ...
}