GPUDevice

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("WebGPU API")}}{{SecureContext_Header}}{{AvailableInWorkers}}

The **GPUDevice** interface of the {{domxref("WebGPU API", "WebGPU API", "", "nocode")}} 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 {{domxref("GPUAdapter.requestDevice()")}} method.

{{InheritanceDiagram}}

Instance properties

_Inherits properties from its parent, {{DOMxRef("EventTarget")}}._

  • {{domxref("GPUDevice.adapterInfo", "adapterInfo")}} {{ReadOnlyInline}}
  • : A {{domxref("GPUAdapterInfo")}} object containing identifying information about the device's originating adapter.
  • {{domxref("GPUDevice.features", "features")}} {{ReadOnlyInline}}
  • : A {{domxref("GPUSupportedFeatures")}} object that describes additional functionality supported by the device.
  • {{domxref("GPUDevice.label", "label")}}
  • : A string providing a label that can be used to identify the object, for example in {{domxref("GPUError")}} messages or console warnings.
  • {{domxref("GPUDevice.limits", "limits")}} {{ReadOnlyInline}}
  • : A {{domxref("GPUSupportedLimits")}} object that describes the limits supported by the device.
  • {{domxref("GPUDevice.lost", "lost")}} {{ReadOnlyInline}}
  • : Contains a {{jsxref("Promise")}} that remains pending throughout the device's lifetime and resolves with a {{domxref("GPUDeviceLostInfo")}} object when the device is lost.
  • {{domxref("GPUDevice.queue", "queue")}} {{ReadOnlyInline}}
  • : Returns the primary {{domxref("GPUQueue")}} for the device.

Instance methods

_Inherits methods from its parent, {{DOMxRef("EventTarget")}}._

  • {{domxref("GPUDevice.createBindGroup", "createBindGroup()")}}
  • : Creates a {{domxref("GPUBindGroup")}} based on a {{domxref("GPUBindGroupLayout")}} that defines a set of resources to be bound together in a group and how those resources are used in shader stages.
  • {{domxref("GPUDevice.createBindGroupLayout", "createBindGroupLayout()")}}
  • : Creates a {{domxref("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 {{domxref("GPUBindGroup")}}s.
  • {{domxref("GPUDevice.createBuffer", "createBuffer()")}}
  • : Creates a {{domxref("GPUBuffer")}} in which to store raw data to use in GPU operations.
  • {{domxref("GPUDevice.createCommandEncoder", "createCommandEncoder()")}}
  • : Creates a {{domxref("GPUCommandEncoder")}}, which is used to encode commands to be issued to the GPU.
  • {{domxref("GPUDevice.createComputePipeline", "createComputePipeline()")}}
  • : Creates a {{domxref("GPUComputePipeline")}} that can control the compute shader stage and be used in a {{domxref("GPUComputePassEncoder")}}.
  • {{domxref("GPUDevice.createComputePipelineAsync", "createComputePipelineAsync()")}}
  • : Returns a {{jsxref("Promise")}} that fulfills with a {{domxref("GPUComputePipeline")}}, which can control the compute shader stage and be used in a {{domxref("GPUComputePassEncoder")}}, once the pipeline can be used without any stalling.
  • {{domxref("GPUDevice.createPipelineLayout", "createPipelineLayout()")}}
  • : Creates a {{domxref("GPUPipelineLayout")}} that defines the {{domxref("GPUBindGroupLayout")}}s used by a pipeline. {{domxref("GPUBindGroup")}}s used with the pipeline during command encoding must have compatible {{domxref("GPUBindGroupLayout")}}s.
  • {{domxref("GPUDevice.createQuerySet", "createQuerySet()")}}
  • : Creates a {{domxref("GPUQuerySet")}} that can be used to record the results of queries on passes, such as occlusion or timestamp queries.
  • {{domxref("GPUDevice.createRenderBundleEncoder", "createRenderBundleEncoder()")}}
  • : Creates a {{domxref("GPURenderBundleEncoder")}} that can be used to pre-record bundles of commands. These can be reused in {{domxref("GPURenderPassEncoder")}}s via the {{domxref("GPURenderPassEncoder.executeBundles", "executeBundles()")}} method, as many times as required.
  • {{domxref("GPUDevice.createRenderPipeline", "createRenderPipeline()")}}
  • : Creates a {{domxref("GPURenderPipeline")}} that can control the vertex and fragment shader stages and be used in a {{domxref("GPURenderPassEncoder")}} or {{domxref("GPURenderBundleEncoder")}}.
  • {{domxref("GPUDevice.createRenderPipelineAsync", "createRenderPipelineAsync()")}}
  • : Returns a {{jsxref("Promise")}} that fulfills with a {{domxref("GPURenderPipeline")}}, which can control the vertex and fragment shader stages and be used in a {{domxref("GPURenderPassEncoder")}} or {{domxref("GPURenderBundleEncoder")}}, once the pipeline can be used without any stalling.
  • {{domxref("GPUDevice.createSampler", "createSampler()")}}
  • : Creates a {{domxref("GPUSampler")}}, which controls how shaders transform and filter texture resource data.
  • {{domxref("GPUDevice.createShaderModule", "createShaderModule()")}}
  • : Creates a {{domxref("GPUShaderModule")}} from a string of WGSL source code.
  • {{domxref("GPUDevice.createTexture", "createTexture()")}}
  • : Creates a {{domxref("GPUTexture")}} in which to store texture data to use in GPU rendering operations.
  • {{domxref("GPUDevice.destroy", "destroy()")}}
  • : Destroys the device, preventing further operations on it.
  • {{domxref("GPUDevice.importExternalTexture", "importExternalTexture()")}}
  • : Takes an {{domxref("HTMLVideoElement")}} as an input and returns a {{domxref("GPUExternalTexture")}} wrapper object containing a snapshot of the video that can be used in GPU rendering operations.
  • {{domxref("GPUDevice.popErrorScope", "popErrorScope()")}}
  • : Pops an existing GPU error scope from the error scope stack and returns a {{jsxref("Promise")}} that resolves to an object ({{domxref("GPUInternalError")}}, {{domxref("GPUOutOfMemoryError")}}, or {{domxref("GPUValidationError")}}) describing the first error captured in the scope, or null if no error occurred.
  • {{domxref("GPUDevice.pushErrorScope", "pushErrorScope()")}}
  • : Pushes a new GPU error scope onto the device's error scope stack, allowing you to capture errors of a particular type.

Events

  • {{domxref("GPUDevice.uncapturederror_event", "uncapturederror")}}
  • : 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 {{domxref("GPUDevice.pushErrorScope", "pushErrorScope()")}} and {{domxref("GPUDevice.popErrorScope", "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:

  • Basic compute demo
  • Basic render demo
  • WebGPU samples

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The WebGPU API