GPUDevice: features-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte features-Eigenschaft der GPUDevice-Schnittstelle gibt ein GPUSupportedFeatures-Objekt zurück, das zusätzliche Funktionalitäten beschreibt, die vom Gerät unterstützt werden. Nur Funktionen, die während der Erstellung des Geräts angefordert wurden (d.h. wenn GPUAdapter.requestDevice() aufgerufen wird), sind enthalten.

Hinweis: Nicht alle Funktionen werden in WebGPU in allen unterstützenden Browsern verfügbar sein, selbst wenn die Funktionen von der zugrunde liegenden Hardware unterstützt werden. Weitere Details finden Sie unter GPUAdapter.features.

Wert

Eine Instanz des GPUSupportedFeatures-Objekts. Dies ist ein setähnliches Objekt.

Beispiele

Im folgenden Code überprüfen wir, ob ein GPUAdapter über die texture-compression-astc-Funktion verfügt. Wenn ja, fügen wir sie in das Array von requiredFeatures ein und fordern ein Gerät mit dieser Funktionsanforderung an, indem wir GPUAdapter.requestDevice() verwenden.

Anschließend protokollieren wir alle Elemente im GPUDevice.features-Set in der Konsole. Dieses Set sollte nur ein einzelnes Element enthalten — texture-compression-astc — da dies die einzige angeforderte Funktion war, als das Gerät erstellt wurde.

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 requiredFeatures = [];

  if (adapter.features.has("texture-compression-astc")) {
    requiredFeatures.push("texture-compression-astc");
  }

  const device = await adapter.requestDevice({
    requiredFeatures,
  });

  device.features.forEach((value) => {
    console.log(value);
  });

  // …
}

Spezifikationen

Specification
WebGPU
# dom-gpudevice-features

Browser-Kompatibilität

Siehe auch