GPUDevice: Methode popErrorScope()

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 popErrorScope()-Methode des GPUDevice-Interfaces entfernt einen bestehenden GPU-Fehlerbereich vom Fehlerbereichs-Stack (ursprünglich mit GPUDevice.pushErrorScope() hinzugefügt) und gibt ein Promise zurück, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt, oder zu null, wenn kein Fehler aufgetreten ist.

Syntax

js
popErrorScope()

Parameter

Keine.

Rückgabewert

Ein Promise, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt. Dies kann von folgendem Typ sein:

Wenn kein Fehler aufgetreten ist, wird es zu null aufgelöst.

Beispiele

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

js
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-poperrorscope

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch