GPUDevice

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 GPUDevice interface of the WebGPU API represents a logical GPU device. This is the main interface through which the majority of WebGPU functionality is accessed.

A GPUDevice object is requested using the GPUAdapter.requestDevice() method.

EventTarget GPUDevice

Instance properties

Inherits properties from its parent, EventTarget.

features Experimental Read only

A GPUSupportedFeatures object that describes additional functionality supported by the device.

label Experimental

A string providing a label that can be used to identify the object, for example in GPUError messages or console warnings.

limits Experimental Read only

A GPUSupportedLimits object that describes the limits supported by the device.

lost Experimental Read only

Contains a Promise that remains pending throughout the device's lifetime and resolves with a GPUDeviceLostInfo object when the device is lost.

queue Experimental Read only

Returns the primary GPUQueue for the device.

Instance methods

Inherits methods from its parent, EventTarget.

createBindGroup() Experimental

Creates a GPUBindGroup based on a GPUBindGroupLayout that defines a set of resources to be bound together in a group and how those resources are used in shader stages.

createBindGroupLayout() Experimental

Creates a GPUBindGroupLayout that defines the structure and purpose of related GPU resources such as buffers that will be used in a pipeline, and is used as a template when creating GPUBindGroups.

createBuffer() Experimental

Creates a GPUBuffer in which to store raw data to use in GPU operations.

createCommandEncoder() Experimental

Creates a GPUCommandEncoder, which is used to encode commands to be issued to the GPU.

createComputePipeline() Experimental

Creates a GPUComputePipeline that can control the compute shader stage and be used in a GPUComputePassEncoder.

createComputePipelineAsync() Experimental

Returns a Promise that fulfills with a GPUComputePipeline, which can control the compute shader stage and be used in a GPUComputePassEncoder, once the pipeline can be used without any stalling.

createPipelineLayout() Experimental

Creates a GPUPipelineLayout that defines the GPUBindGroupLayouts used by a pipeline. GPUBindGroups used with the pipeline during command encoding must have compatible GPUBindGroupLayouts.

createQuerySet() Experimental

Creates a GPUQuerySet that can be used to record the results of queries on passes, such as occlusion or timestamp queries.

createRenderBundleEncoder() Experimental

Creates a GPURenderBundleEncoder that can be used to pre-record bundles of commands. These can be reused in GPURenderPassEncoders via the executeBundles() method, as many times as required.

createRenderPipeline() Experimental

Creates a GPURenderPipeline that can control the vertex and fragment shader stages and be used in a GPURenderPassEncoder or GPURenderBundleEncoder.

createRenderPipelineAsync() Experimental

Returns a Promise that fulfills with a GPURenderPipeline, which can control the vertex and fragment shader stages and be used in a GPURenderPassEncoder or GPURenderBundleEncoder, once the pipeline can be used without any stalling.

createSampler() Experimental

Creates a GPUSampler, which controls how shaders transform and filter texture resource data.

createShaderModule() Experimental

Creates a GPUShaderModule from a string of WGSL source code.

createTexture() Experimental

Creates a GPUTexture in which to store texture data to use in GPU rendering operations.

destroy() Experimental

Destroys the device, preventing further operations on it.

importExternalTexture() Experimental

Takes an HTMLVideoElement as an input and returns a GPUExternalTexture wrapper object containing a snapshot of the video that can be used in GPU rendering operations.

popErrorScope() Experimental

Pops an existing GPU error scope from the error scope stack and returns a Promise that resolves to an object (GPUInternalError, GPUOutOfMemoryError, or GPUValidationError) describing the first error captured in the scope, or null if no error occurred.

pushErrorScope() Experimental

Pushes a new GPU error scope onto the device's error scope stack, allowing you to capture errors of a particular type.

Events

uncapturederror Experimental

Fired when an error is thrown that has not been observed by a GPU error scope, to provide a way to report unexpected errors. Known error cases should be handled using pushErrorScope() and popErrorScope().

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

  const shaderModule = device.createShaderModule({
    code: shaders,
  });

  //...
}

See the individual member pages listed above and the following demo sites for a lot more examples of GPUDevice usage:

Specifications

Specification
WebGPU
# gpudevice

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
GPUDevice
Experimental
adapterInfo
Experimental
createBindGroup
Experimental
createBindGroupLayout
Experimental
read-write and read-only storageTexture.access
Experimental
rgb10a2uint texture format
Experimental
createBuffer
Experimental
createCommandEncoder
Experimental
createComputePipeline
Experimental
entryPoint properties are optional for determined default compute shader entry points.
Experimental
createComputePipelineAsync
Experimental
entryPoint properties are optional for determined default compute shader entry points.
Experimental
createPipelineLayout
Experimental
createQuerySet
Experimental
Create timestamp queryset types
Experimental
createRenderBundleEncoder
Experimental
createRenderPipeline
Experimental
Dual-source blending: src1, one-minus-src1, src1-alpha, and one-minus-src1-alpha blend factors.
Experimental
depthCompare and depthWriteEnabled properties are optional when not needed (for example, formats without depth).
Experimental
entryPoint properties are optional for determined default fragment and vertex shader entry points.
Experimental
rgb10a2uint texture format
Experimental
Validates that depthBias, depthBiasSlopeScale, and depthBiasClamp must be 0 for line and point topologies.
Experimental
unorm10-10-10-2 vertex format
Experimental
createRenderPipelineAsync
Experimental
Dual-source blending: src1, one-minus-src1, src1-alpha, and one-minus-src1-alpha blend factors.
Experimental
depthCompare and depthWriteEnabled properties are optional when not needed (for example, formats without depth).
Experimental
entryPoint properties are optional for determined default fragment and vertex shader entry points.
Experimental
rgb10a2uint texture format
Experimental
Validates that depthBias, depthBiasSlopeScale, and depthBiasClamp must be 0 for line and point topologies.
Experimental
unorm10-10-10-2 vertex format
Experimental
createSampler
Experimental
createShaderModule
Experimental
createTexture
Experimental
rgb10a2uint texture format
Experimental
destroy
Experimental
features
Experimental
importExternalTexture
Experimental
display-p3 color space
Experimental
VideoFrame object as source
Experimental
label
Experimental
limits
Experimental
lost
Experimental
popErrorScope
Experimental
pushErrorScope
Experimental
queue
Experimental
uncapturederror event
Experimental

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.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.

See also