WebGPU

Warning

The WebGPU API is only available in local development. You cannot deploy Durable Objects to Cloudflare that rely on the WebGPU API. See Workers AI for information on running machine learning models on the GPUs in Cloudflare's global network.

The WebGPU API ↗ allows you to use the GPU directly from JavaScript.

The WebGPU API is only accessible from within Durable Objects. You cannot use the WebGPU API from within Workers.

To use the WebGPU API in local development, enable the experimental and webgpu compatibility flags in the wrangler.toml configuration file of your Durable Object.

compatibility_flags = ["experimental", "webgpu"]

The following subset of the WebGPU API is available from within Durable Objects:

API	Supported?	Notes
navigator.gpu ↗	✅
GPU.requestAdapter ↗	✅
GPUAdapterInfo ↗	✅
GPUAdapter ↗	✅
GPUBindGroupLayout ↗	✅
GPUBindGroup ↗	✅
GPUBuffer ↗	✅
GPUCommandBuffer ↗	✅
GPUCommandEncoder ↗	✅
GPUComputePassEncoder ↗	✅
GPUComputePipeline ↗	✅
GPUComputePipelineError ↗	✅
GPUDevice ↗	✅
GPUOutOfMemoryError ↗	✅
GPUValidationError ↗	✅
GPUInternalError ↗	✅
GPUDeviceLostInfo ↗	✅
GPUPipelineLayout ↗	✅
GPUQuerySet ↗	✅
GPUQueue ↗	✅
GPUSampler ↗	✅
GPUCompilationMessage ↗	✅
GPUShaderModule ↗	✅
GPUSupportedFeatures ↗	✅
GPUSupportedLimits ↗	✅
GPUMapMode ↗	✅
GPUShaderStage ↗	✅
GPUUncapturedErrorEvent ↗	✅

The following subset of the WebGPU API is not yet supported:

API	Supported?	Notes
GPU.getPreferredCanvasFormat ↗
GPURenderBundle ↗
GPURenderBundleEncoder ↗
GPURenderPassEncoder ↗
GPURenderPipeline ↗
GPUShaderModule ↗
GPUTexture ↗
GPUTextureView ↗
GPUExternalTexture ↗

Examples

• workers-wonnx ↗ — Image classification, running on a GPU via the WebGPU API, using the wonnx ↗ model inference runtime.

Was this helpful?

What did you like?

Accurate

Easy to understand

Solved my problem

Helped me decide to use the product

Other

What went wrong?

Hard to understand

Incorrect information

Missing the information

Other

Thank you for helping improve Cloudflare's documentation!