WGSLLanguageFeatures

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 WGSLLanguageFeatures interface of the WebGPU API is a setlike object that reports the WGSL language extensions supported by the WebGPU implementation.

The WGSLLanguageFeatures object is accessed via the GPU.wgslLanguageFeatures property.

Note: Not all WGSL language extensions are available to WebGPU in all browsers that support the API. We recommend you thoroughly test any extensions you choose to use.

Available features

The following WGSL language extensions are defined at WGSL language extensions in the WGSL specification. Bear in mind that the exact set of features available will vary across implementations and physical devices, and may change over time.

packed_4x8_integer_dot_product

Allows DP4a (Dot Product of 4 Elements and Accumulate) GPU instructions to be used via your WGSL code. These efficiently perform 8-bit integer dot products to accelerate computation, saving memory and network bandwidth and improving performance compared with the equivalent f32 versions. They are commonly used in machine learning models in inferencing, within AI frameworks.

Specifically, when packed_4x8_integer_dot_product is available, WGSL code can use:

  • 32-bit integer scalars packing 4-component vectors of 8-bit integers to be used as inputs to dot product instructions (via the dot4U8Packed() and dot4I8Packed() built-in functions).
  • Packing and unpacking instructions with packed 4-component vectors of 8-bit integers (via built-in functions such as pack4xI8() and pack4xI8Clamp()).
readonly_and_readwrite_storage_textures

When available, allows the "read-only" and "read-write" storageTexture.access values to be set when specifying storage texture bind group entry types in a bind group layout. These enable WGSL code to read storage textures, and read/write storage textures, respectively.

unrestricted_pointer_parameters

Loosens restrictions on pointers being passed to WGSL functions. When available, the following are allowed:

  • Parameter pointers to storage, uniform, and workgroup address spaces being passed to user-declared functions.

  • Pointers to structure members and array elements being passed to user-declared functions.

    See Pointers As Function Parameters for more details.

Instance properties

The following property is available to all read-only setlike objects:

size

Returns the number of values in the set.

Instance methods

The following methods are available to all read-only setlike objects:

has()

Returns a boolean asserting whether or not an element with the given value is present in the set.

values()

Returns a new iterator object that yields values for each element in the set in insertion order.

keys()

An alias for values().

entries()

Returns a new iterator object that contains an array of [value, value] for each element in the set in insertion order.

forEach()

Calls the provided callback function once for each value present in the set in insertion order.

Examples

Check whether an extension is available

js
if (
  navigator.gpu.wgslLanguageFeatures.has(
    "readonly_and_readwrite_storage_textures",
  )
) {
  console.log("Read-only and read-write storage textures are available");
}

Return set size and iterate through values

js
const wgslFeatures = navigator.gpu.wgslLanguageFeatures;

// Return the size of the set
console.log(wgslFeatures.size);

// Iterate through all the set values using values()
const valueIterator = wgslFeatures.values();
for (const value of valueIterator) {
  console.log(value);
}

// ...

Specifications

Specification
WebGPU
# gpuwgsllanguagefeatures

Browser compatibility

BCD tables only load in the browser

See also