GPUDevice: pushErrorScope() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 pushErrorScope() Methode der GPUDevice Schnittstelle fügt einen neuen Fehlerbereich (Error Scope) zum Fehlerbereichs-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. Dies entfernt den Bereich vom Stack und gibt ein Promise zurück, das auf ein Objekt aufgelöst wird, welches den ersten im Bereich erfassten Fehler beschreibt, oder null, wenn keine Fehler erfasst wurden.
Syntax
pushErrorScope(filter)
Parameter
filter-
Ein enumerierter Wert, der angibt, welche Art von Fehler in diesem spezifischen Fehlerbereich erfasst wird. Mögliche Werte sind:
"internal"-
Der Fehlerbereich wird einen
GPUInternalErrorerfassen. "out-of-memory"-
Der Fehlerbereich wird einen
GPUOutOfMemoryErrorerfassen. "validation"-
Der Fehlerbereich wird einen
GPUValidationErrorerfassen.
Rückgabewert
Keiner (undefined).
Beispiele
Das folgende Beispiel verwendet einen Fehlerbereich, um einen vermuteten Validierungsfehler zu erfassen und 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 WebGPU Fehlerbehandlung Best Practices für viele weitere Beispiele und Informationen.
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpudevice-pusherrorscope |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API