GPUDevice: uncapturederror-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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.
Das uncapturederror-Ereignis der GPUDevice-Schnittstelle wird ausgelöst, wenn ein Fehler auftritt, der von keinem GPU-Fehlerbereich erfasst wurde. Es bietet eine Möglichkeit, unerwartete Fehler zu melden.
Bekannte Fehlerfälle sollten mit pushErrorScope() und popErrorScope() behandelt werden.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("uncapturederror", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onuncapturederror = (event) => { }
Ereignistyp
Ein GPUUncapturedErrorEvent. Erbt von Event.
Beispiele
Sie können beispielsweise Folgendes als globalen Mechanismus verwenden, um Fehler zu erfassen, die nicht durch Fehlerbereiche behandelt werden:
device.addEventListener("uncapturederror", (event) => {
// Re-surface the error.
console.error("A WebGPU error was not captured:", event.error);
reportErrorToServer({
type: event.error.constructor.name,
message: event.error.message,
});
});
Weitere Beispiele und Informationen finden Sie unter Best Practices für die Fehlerbehandlung in WebGPU.
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpudevice-onuncapturederror |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API