GPUDevice: uncapturederror Ereignis

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 vor der Verwendung auf produktiven Webseiten.

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 beobachtet wurde, um eine Möglichkeit zum Melden 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 Ereignishandler-Eigenschaft.

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

onuncapturederror = (event) => {};

Ereignistyp

Ein GPUUncapturedErrorEvent. Erbt von Event.

Event GPUUncapturedErrorEvent

Beispiele

Sie könnten etwas wie Folgendes als globale Mechanismus benutzen, um Fehler, die nicht von Fehlerbereichen behandelt werden, aufzufangen und zu erfassen.

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 WebGPU Error Handling best practices für weitere Beispiele und Informationen.

Spezifikationen

Specification
WebGPU
# dom-gpudevice-onuncapturederror

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch