GPUAdapter
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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
Experimental Read only-
A
GPUSupportedFeatures
object that describes additional functionality supported by the adapter. isFallbackAdapter
Experimental Read only-
A boolean value. Returns
true
if the adapter is a fallback adapter, andfalse
if not. info
Experimental Read only-
A
GPUAdapterInfo
object containing identifying information about the adapter. limits
Experimental Read only-
A
GPUSupportedLimits
object that describes the limits supported by the adapter.
Instance methods
requestAdapterInfo()
Deprecated Non-standard-
Returns a
Promise
that fulfills with aGPUAdapterInfo
object containing identifying information about the adapter. requestDevice()
Experimental-
Returns a
Promise
that fulfills with aGPUDevice
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();
//...
}
Specifications
Specification |
---|
WebGPU # gpu-adapter |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GPUAdapter | |||||||||||||
features | |||||||||||||
info | |||||||||||||
isFallbackAdapter | |||||||||||||
limits | |||||||||||||
requestAdapterInfo | |||||||||||||
requestDevice | |||||||||||||
Lost GPUDevice returned on duplicate calls. |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- 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.
- See implementation notes.
- User must explicitly enable this feature.
- Has more compatibility info.
See also
- The WebGPU API