WorkerGlobalScope: rejectionhandled-Ereignis

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

Das rejectionhandled-Ereignis wird an den globalen Gültigkeitsbereich des Skripts gesendet (typischerweise WorkerGlobalScope), wenn ein abgelehntes Promise nachträglich behandelt wird, d.h. wenn ein Handler an das Promise angefügt wird, nachdem dessen Ablehnung ein unhandledrejection-Ereignis verursacht hat.

Dies kann beim Debugging und für die allgemeine Anwendungsresilienz verwendet werden, zusammen mit dem unhandledrejection-Ereignis, das gesendet wird, wenn ein Promise abgelehnt wird, aber zum Zeitpunkt der Ablehnung kein Handler vorhanden ist.

Syntax

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

js
self.addEventListener("rejectionhandled", (event) => {});
self.onrejectionhandled = (event) => {};

Ereignistyp

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 es an Promise.reject() übergeben wurde.

Beispiel

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

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

Spezifikationen

Specification
HTML
# handler-workerglobalscope-onrejectionhandled

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
rejectionhandled event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch