Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

WorkerGlobalScope: rejectionhandled Ereignis

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist nur in Web Workers verfügbar.

Das rejectionhandled Ereignis wird an den globalen Bereich des Skripts gesendet (typischerweise WorkerGlobalScope), immer wenn ein abgelehntes Promise verspätet behandelt wird, d.h. wenn ein Handler an das Promise angehängt wird, nachdem seine Ablehnung ein unhandledrejection Ereignis verursacht hat.

Dies kann beim Debuggen und für die allgemeine Anwendungsresilienz in Verbindung mit dem unhandledrejection Ereignis verwendet werden, welches gesendet wird, wenn ein Promise abgelehnt wird, es jedoch zum Zeitpunkt der Ablehnung keinen Handler gibt.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignishandler-Eigenschaft fest.

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

onrejectionhandled = (event) => { }

Ereignistyp

Ein PromiseRejectionEvent. Erbt von Event.

Event PromiseRejectionEvent

Ereigniseigenschaften

PromiseRejectionEvent.promise Schreibgeschützt

Das abgelehnte Promise.

PromiseRejectionEvent.reason Schreibgeschützt

Ein Wert oder ein Object, der angibt, warum das Promise abgelehnt wurde, wie an Promise.reject() übergeben.

Beispiel

Sie können das rejectionhandled Ereignis verwenden, um abgelehnte Promises zusammen mit den Gründen für die Ablehnung im Konsolenprotokoll aufzuzeichnen:

js
self.addEventListener("rejectionhandled", (event) => {
  console.log(`Promise rejected; reason: ${event.reason}`);
});

Spezifikationen

Spezifikation
HTML
# handler-workerglobalscope-onrejectionhandled

Browser-Kompatibilität

Siehe auch