WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Promise.reject — ein abgelehntes Promise erstellen

Promise.reject(reason) erstellt ein neues abgelehntes Promise mit dem angegebenen Grund. Ablehnungs-Handler werden asynchron ausgeführt, obwohl das zurückgegebene Promise bereits beim Zurückgeben abgelehnt ist.

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

Promise.reject(reason)

Promise.reject(reason) ist eine statische Methode des Promise-Konstruktors. Sie gibt ein neues Promise im abgelehnten Zustand zurück, dessen Ablehnungsgrund reason ist. Der Grund kann ein beliebiger Wert sein; wird das Argument weggelassen, wird undefined verwendet. Bei Fehlern empfiehlt sich ein Error-Objekt.

Die Methode übernimmt nicht den Zustand eines übergebenen Promise oder eines Objekts mit einer then-Methode (eines Thenables). Das Argument selbst wird zum Ablehnungsgrund. Anders als Promise.resolve gibt Promise.reject ein übergebenes Promise nicht unverändert zurück.

Ein gewöhnlicher Aufruf von Promise.reject(reason) ist kein synchrones throw: Ein umgebendes try...catch fängt die Ablehnung selbst nicht ab. Verwende .catch(...) oder ein try...catch um await. Promise-Handler werden erst ausgeführt, nachdem der aktuelle synchrone Code beendet ist. Behandle Ablehnungen; wie die Laufzeitumgebung auf eine unbehandelte Ablehnung reagiert, hängt von der Host-Umgebung ab.

Im Beispiel erscheint sync, bevor der Ablehnungs-Handler ausgeführt wird, und true bestätigt, dass der Grund seine Identität beibehält. Rufe die Methode als Promise.reject(...) auf: Ihr this muss ein Konstruktor sein, der mit den Konventionen des Promise-Konstruktors kompatibel ist. Ein losgelöster Aufruf ohne den passenden Empfänger kann daher einen TypeError auslösen.

Beispiele

const reason = new Error("Invalid input");
const rejected = Promise.reject(reason);

rejected.catch((error) => {
  console.log(error === reason);
  console.log(error.message);
});

console.log("sync");

Ergebnis

sync
true
Invalid input

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