GPUDevice: uncapturederror Ereignis

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.

Das uncapturederror Ereignis der GPUDevice Schnittstelle wird ausgelöst, wenn ein Fehler auftritt, der nicht von einem GPU-Fehlerbereich erfasst wurde, um eine Möglichkeit zur Meldung unerwarteter Fehler bereitzustellen.

Bekannte Fehlerfälle sollten mit pushErrorScope() und popErrorScope() behandelt werden.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignisbehandlungseigenschaft.

js
addEventListener("uncapturederror", (event) => { })

onuncapturederror = (event) => { }

Ereignistyp

Ein GPUUncapturedErrorEvent. Erbt von Event.

Event GPUUncapturedErrorEvent

Beispiele

Sie könnten etwas wie das Folgende als globalen Mechanismus verwenden, um alle Fehler zu erfassen, die nicht von Fehlerbereichen behandelt werden.

js
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,
  });
});

Siehe Beste Praktiken für die Fehlerbehandlung in WebGPU für weitere Beispiele und Informationen.

Spezifikationen

Specification
WebGPU
# dom-gpudevice-onuncapturederror

Browser-Kompatibilität

Siehe auch