GPUDevice: `features`-Eigenschaft

Limited availability

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

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 des GPUDevice-Interfaces 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 allen Browsern, die WebGPU unterstützen, verfügbar sein, auch 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 die Funktion texture-compression-astc verfügbar hat. Wenn ja, fügen wir sie dem Array requiredFeatures hinzu und fordern ein Gerät mit dieser Funktionsanforderung unter Verwendung von GPUAdapter.requestDevice() an.

Wir protokollieren dann alle Elemente im GPUDevice.features-Set in die Konsole. Dieses Set sollte nur ein einzelnes 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