WorkerGlobalScope: rejectionhandled-Ereignis

Hinweis: Dieses Feature ist nur verfügbar in Web Workers.

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 Nur lesbar

Das abgelehnte Promise.

PromiseRejectionEvent.reason Nur lesbar

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 Standard
# handler-workerglobalscope-onrejectionhandled

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch