GPUUncapturedErrorEvent

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 GPUUncapturedErrorEvent-Interface der WebGPU-API ist der Ereignisobjekttyp für das GPUDevice-uncapturederror-Ereignis, das für Telemetrie genutzt wird und um unerwartete Fehler zu melden.

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

Konstruktor

GPUUncapturedErrorEvent(): Erstellt eine neue Instanz des GPUUncapturedErrorEvent-Objekts.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem übergeordneten Element, Event.

error Schreibgeschützt: Eine GPUError-Objektinstanz, die Zugriff auf die Details des Fehlers bietet.

Beispiele

Sie könnten so etwas wie das Folgende verwenden, um einen globalen Mechanismus zu schaffen, der alle Fehler erfasst, die nicht von Fehlerbereichen behandelt werden, und sie auffängt.

// …

device.addEventListener("uncapturederror", (event) => {
  // Re-surface the error
  console.error("A WebGPU error was not captured:", event.error.message);
  reportErrorToServer({
    type: event.error.constructor.name,
    message: event.error.message,
  });
});

// …

Spezifikationen

Specification
WebGPU # gpuuncapturederrorevent