Window: rejectionhandled Ereignis

Das rejectionhandled-Ereignis wird an den globalen Gültigkeitsbereich des Skripts gesendet (normalerweise window, aber auch Worker), wann immer ein abgelehntes JavaScript-Promise verspätet behandelt wird, d.h. wenn ein Handler an das Promise angehängt wird, nachdem dessen Ablehnung ein unhandledrejection-Ereignis verursacht hatte.

Dies kann beim Debuggen und für die allgemeine Widerstandsfähigkeit von Anwendungen in Verbindung mit dem unhandledrejection-Ereignis genutzt werden, das gesendet wird, wenn ein Promise abgelehnt wird, aber zu diesem Zeitpunkt kein Handler für die Ablehnung vorhanden ist.

Syntax

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

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

onrejectionhandled = (event) => { }

Ereignistyp

Ein PromiseRejectionEvent. Erbt von Event.

Ereigniseigenschaften

PromiseRejectionEvent.promise Schreibgeschützt: Das JavaScript-Promise, das abgelehnt wurde.
PromiseRejectionEvent.reason Schreibgeschützt: Ein Wert oder ein Object, das angibt, warum das Promise abgelehnt wurde, wie es an Promise.reject() übergeben wurde.

Aliase für Ereignis-Handler

Zusätzlich zur Window-Schnittstelle ist die Ereignis-Handler-Eigenschaft onrejectionhandled auch bei folgenden Zielen verfügbar:

Beispiel

Sie können das rejectionhandled-Ereignis verwenden, um Versprechen, die abgelehnt werden, zusammen mit den Gründen, warum sie abgelehnt wurden, in die Konsole zu protokollieren:

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

Spezifikationen

Specification
HTML # unhandled-promise-rejections
HTML # handler-window-onrejectionhandled