WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

PromiseRejectionEvent.reason — Ablehnungsgrund eines Promises

PromiseRejectionEvent.reason stellt den Ablehnungsgrund in unhandledrejection- und rejectionhandled-Ereignissen bereit. Die Eigenschaft ist schreibgeschützt, ihr Wert kann jedoch ein beliebiger JavaScript-Wert sein, nicht nur ein Error-Objekt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

event.reason
new PromiseRejectionEvent(type, { promise, reason })

PromiseRejectionEvent ist eine Web-API-Schnittstelle, die von Event erbt und nicht Teil von ECMAScript selbst ist. Die Eigenschaft PromiseRejectionEvent.reason, gelesen als event.reason, enthält den Ablehnungsgrund. Das kann eine Zeichenfolge, eine Zahl, ein Error, ein anderes Objekt oder undefined sein. Gehe daher nicht davon aus, dass event.reason.message existiert.

reason ist schreibgeschützt. Dagegen bezeichnet event.promise das Promise, auf das sich das Ereignis bezieht: Die Eigenschaften stehen jeweils für den Grund und das Promise, nicht für zwei Möglichkeiten, dasselbe auszulesen.

unhandledrejection meldet eine Ablehnung, für die kein Ablehnungshandler verfügbar ist. rejectionhandled bedeutet, dass ein Handler später hinzugefügt wurde, nachdem unhandledrejection bereits gemeldet worden war. Globale Listener helfen bei der Diagnose, ersetzen aber keine Fehlerbehandlung mit .catch() oder try/catch um await.

Das Beispiel erstellt manuell ein Ereignis, um den Eigenschaftszugriff zuverlässig zu veranschaulichen. Das Argument reason des Konstruktors legt den Wert in diesem synthetischen Ereignis fest; durch das Erstellen des Ereignisses wird weder ein Promise abgelehnt noch das Ereignis ausgelöst. Das sofortige .catch() verhindert eine tatsächliche unbehandelte Ablehnung.

Führe das Beispiel in einem Browser aus, der PromiseRejectionEvent bereitstellt. Diese API ist auch in Web Workers verfügbar; das Vorhandensein von Promise oder die Verwendung von Node 24 belegt nicht, dass diese Browser-Schnittstelle unterstützt wird.

Beispiele

(() => {
  const reason = "TASK_FAILED";
  const promise = Promise.reject(reason);
  promise.catch(() => {});

  const event = new PromiseRejectionEvent("unhandledrejection", {
    promise,
    reason,
  });

  console.log(event.reason);
  console.log(event.promise === promise);
})();

Ergebnis

TASK_FAILED
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen