Window: rejectionhandled-Event

Das rejectionhandled-Event wird an den globalen Bereich des Skripts gesendet (normalerweise window, aber auch Worker), wann immer ein abgelehntes JavaScript-Promise spät behandelt wird, d.h. wenn ein Handler dem Promise hinzugefügt wird, nachdem seine Ablehnung ein unhandledrejection-Event verursacht hatte.

Dies kann beim Debuggen und zur allgemeinen Anwendungsstabilität zusammen mit dem unhandledrejection-Event verwendet werden, das gesendet wird, wenn ein Promise abgelehnt wird, aber zum Zeitpunkt der Ablehnung kein Handler vorhanden ist.

Syntax

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

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

Event-Typ

Ein PromiseRejectionEvent. Erbt von Event.

Event-Eigenschaften

PromiseRejectionEvent.promise Schreibgeschützt

Das JavaScript-Promise, das abgelehnt wurde.

PromiseRejectionEvent.reason Schreibgeschützt

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

Event-Handler-Aliase

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

• HTMLBodyElement
• HTMLFrameSetElement
• SVGSVGElement

Beispiel

Sie können das rejectionhandled-Event verwenden, um Promises, 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}`);
});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Promise-Rejection-Events
• PromiseRejectionEvent
• Promise
• unhandledrejection