GPUDevice: popErrorScope()-Methode
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 popErrorScope()-Methode der GPUDevice-Schnittstelle entfernt einen bestehenden GPU-Fehlerbereich aus dem Fehlerbereichsstapel (ursprünglich mit GPUDevice.pushErrorScope() hinzugefügt) und gibt ein Promise zurück, das ein Objekt beschreibt, welches den ersten im Bereich erfassten Fehler darstellt, oder null, falls kein Fehler aufgetreten ist.
Syntax
popErrorScope()
Parameter
Keine.
Rückgabewert
Ein Promise, das ein Objekt beschreibt, welches den ersten im Bereich erfassten Fehler darstellt. Dieser kann vom Typ sein:
Falls kein Fehler aufgetreten ist, wird null zurückgegeben.
Beispiele
Das folgende Beispiel verwendet einen Fehlerbereich, um einen vermuteten Validierungsfehler zu erfassen und ihn im Konsolenprotokoll 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 Best Practices für die Fehlerbehandlung in WebGPU für viele weitere Beispiele und Informationen.
Spezifikationen
| Specification |
|---|
| WebGPU # dom-gpudevice-poperrorscope |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API