GPUDevice: pushErrorScope()-Methode

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, bevor Sie diese produktiv verwenden.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die pushErrorScope()-Methode der GPUDevice-Schnittstelle fügt einen neuen GPU-Fehlerbereich zum Fehlerbereich-Stack des Geräts hinzu, wodurch Sie Fehler eines bestimmten Typs erfassen können.

Sobald Sie mit der Erfassung von Fehlern fertig sind, können Sie die Erfassung beenden, indem Sie GPUDevice.popErrorScope() aufrufen. Dadurch wird der Bereich aus dem Stapel entfernt und es wird ein Promise zurückgegeben, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt, oder null, wenn keine Fehler erfasst wurden.

Syntax

pushErrorScope(filter)

Parameter

filter

Ein enumerierter Wert, der angibt, welcher Typ von Fehler in diesem speziellen Fehlerbereich erfasst wird. Mögliche Werte sind:

"internal": Der Fehlerbereich erfasst einen GPUInternalError.
"out-of-memory": Der Fehlerbereich erfasst einen GPUOutOfMemoryError.
"validation": Der Fehlerbereich erfasst einen GPUValidationError.

Rückgabewert

Keiner (Undefined).

Beispiele

Das folgende Beispiel verwendet einen Fehlerbereich, um einen vermuteten Validierungsfehler zu erfassen und ihn in der Konsole auszugeben.

device.pushErrorScope("validation");

let sampler = device.createSampler({
  maxAnisotropy: 0, // Invalid, maxAnisotropy must be at least 1.
});

device.popErrorScope().then((error) => {
  if (error) {
    sampler = null;
    console.error(`An error occurred while creating sampler: ${error.message}`);
  }
});

Siehe WebGPU Error Handling best practices für viele weitere Beispiele und Informationen.

Spezifikationen

Specification
WebGPU # dom-gpudevice-pusherrorscope

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Die WebGPU API