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
featuresRead only-
A
GPUSupportedFeaturesobject that describes additional functionality supported by the adapter. infoRead only-
A
GPUAdapterInfoobject containing identifying information about the adapter. limitsRead only-
A
GPUSupportedLimitsobject that describes the limits supported by the adapter.
Deprecated properties
isFallbackAdapterRead only-
A boolean value. Returns
trueif the adapter is a fallback adapter, andfalseif not. This property has been removed from the web platform. UseGPUAdapterInfo.isFallbackAdapterinstead.
Instance methods
requestAdapterInfo()-
Returns a
Promisethat fulfills with aGPUAdapterInfoobject containing identifying information about the adapter. requestDevice()-
Returns a
Promisethat fulfills with aGPUDeviceobject, which is the primary interface for communicating with the GPU.
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.");
}
const device = await adapter.requestDevice();
// …
}
Specifications
| Specification |
|---|
| WebGPU # gpuadapter |
Browser compatibility
| desktop | mobile | server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GPUAdapter
|
|
|
|
|
|
|
|
|
|
|
|
|
|
features
|
|
|
|
|
|
|
|
|
|
|
|
|
|
info
|
|
|
|
|
|
|
|
|
|
|
|
|
|
isFallbackAdapter
|
|
|
|
|
|
|
|
|
|
|
|
|
|
limits
|
|
|
|
|
|
|
|
|
|
|
|
|
|
requestAdapterInfo
|
|
|
|
|
|
|
|
|
|
|
|
|
|
requestDevice
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rejects duplicate calls as adapter is consumed.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Request unknown limits with
undefined value
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Non-standard. Check cross-browser support before using.
- Deprecated. Not for use in new websites.
- User must explicitly enable this feature.
- Has more compatibility info.
See also
- The WebGPU API