GPUSupportedFeatures
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The GPUSupportedFeatures
interface of the WebGPU API is a Set
-like object that describes additional functionality supported by a GPUAdapter
.
The GPUSupportedFeatures
object for the current adapter is accessed via the GPUAdapter.features
property.
You should note that not all features will be available to WebGPU in all browsers that support it, even if the features are supported by the underlying hardware. This could be due to constraints in the underlying system, browser, or adapter. For example:
- The underlying system might not be able to guarantee exposure of a feature in a way that is compatible with a certain browser.
- The browser vendor might not have found a secure way to implement support for that feature, or might just not have gotten round to it yet.
If you are hoping to take advantage of a specific additional feature in a WebGPU app, thorough testing is advised.
Available features
We have not listed the exact set of additional features available to be used in WebGPU, as it will vary between implementations and physical devices, and will change over time. For a list, refer to the Feature Index in the specification.
Instance properties
The following properties are available to all read-only Set
-like objects (the links below are to the Set
global object reference page).
size
Experimental-
Returns the number of values in the set.
Instance methods
The following methods are available to all read-only Set
-like objects (the below links are to the Set
global object reference page).
has()
Experimental-
Returns a boolean asserting whether an element is present with the given value in the set or not.
values()
Experimental-
Returns a new iterator object that yields the values for each element in the set in insertion order.
keys()
Experimental-
An alias for
values()
. entries()
Experimental-
Returns a new iterator object that contains an array of
[value, value]
for each element in the set, in insertion order. forEach()
Experimental-
Calls a provided callback function once for each value present in the set, in insertion order.
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 adapterFeatures = adapter.features;
// Return the size of the set
console.log(adapterFeatures.size);
// Check whether a feature is supported by the adapter
console.log(adapterFeatures.has("texture-compression-astc"));
// Iterate through all the set values using values()
const valueIterator = adapterFeatures.values();
for (const value of valueIterator) {
console.log(value);
}
// Iterate through all the set values using keys()
const keyIterator = adapterFeatures.keys();
for (const value of keyIterator) {
console.log(value);
}
// Iterate through all the set values using entries()
const entryIterator = adapterFeatures.entries();
for (const entry of entryIterator) {
console.log(entry[0]);
}
// Iterate through all the set values using forEach()
adapterFeatures.forEach((value) => {
console.log(value);
});
//...
}
Specifications
Specification |
---|
WebGPU # gpu-supportedfeatures |
Browser compatibility
BCD tables only load in the browser
See also
- The WebGPU API