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.