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 features schreibgeschützte Eigenschaft der GPUDevice-Schnittstelle gibt ein GPUSupportedFeatures-Objekt zurück, das zusätzliche Funktionalitäten beschreibt, die von dem 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. Siehe GPUAdapter.features für weitere Details.

Wert

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

Beispiele

Im folgenden Code überprüfen wir, ob ein GPUAdapter die Funktion texture-compression-astc zur Verfügung hat. Wenn ja, fügen wir sie in das Array von requiredFeatures ein und fordern ein Gerät mit dieser Funktionalitätsanforderung unter Verwendung von GPUAdapter.requestDevice() an.

Wir protokollieren dann alle Elemente in der Menge GPUDevice.features in der Konsole. Diese Menge sollte nur ein einziges Element enthalten — texture-compression-astc — da dies die einzige Funktion war, die bei der Erstellung des Geräts angefordert 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