GPUAdapterInfo

Secure contextAvailable in workers

The GPUAdapterInfo interface of the WebGPU API contains identifying information about a GPUAdapter.

An adapter’s GPUAdapterInfo can be retrieved using the info property of the adapter itself, or the adapterInfo property of a device that originated from the adapter.

This object allows developers to access specific details about the user’s GPU so that they can preemptively apply workarounds for GPU-specific bugs, or provide different codepaths to better suit different GPU architectures. Providing such information does present a security risk — it could be used for fingerprinting — therefore the information shared is kept at a minimum, and different browser vendors are likely to share different information types and granularities.

Instance properties

• architecture Read only
  • : The name of the family or class of GPUs the adapter belongs to. Returns an empty string if it is not available.
• description Read only
  • : A human-readable string describing the adapter. Returns an empty string if it is not available.
• device Read only
  • : A vendor-specific identifier for the adapter. Returns an empty string if it is not available.
• isFallbackAdapter Read only
  • : A boolean value. Returns true if the adapter is a fallback adapter, and false if not.
• subgroupMaxSize Read only
  • : The maximum supported subgroup size for the GPUAdapter.
• subgroupMinSize Read only
  • : The minimum supported subgroup size for the GPUAdapter.
• vendor Read only
  • : The name of the adapter vendor. Returns an empty string if it is not available.

Examples

Access GPUAdapterInfo via GPUAdapter.info

const adapter = await navigator.gpu.requestAdapter();
if (!adapter) {
  throw Error("Couldn't request WebGPU adapter.");
}

const adapterInfo = adapter.info;
console.log(adapterInfo.vendor);
console.log(adapterInfo.architecture);

Access GPUAdapterInfo via GPUDevice.adapterInfo

const adapter = await navigator.gpu.requestAdapter();
if (!adapter) {
  throw Error("Couldn't request WebGPU adapter.");
}

const myDevice = await adapter.requestDevice();

function optimizeForGpuDevice(device) {
  if (device.adapterInfo.vendor === "amd") {
    // Use AMD-specific optimizations
  } else if (device.adapterInfo.architecture.includes("turing")) {
    // Optimize for NVIDIA Turing architecture
  }
}

optimizeForGpuDevice(myDevice);

Specifications

Browser compatibility

See also

• info
• The WebGPU API