CKTIS / JavaScript
Promise.prototype.catch — Ablehnungen behandeln
Die Methode catch() fügt einen Handler für die Ablehnung eines Promise hinzu. Damit lässt sich ein erfolgreicher Wert zurückgeben oder ein Fehler weiterreichen; mit der standardmäßigen then-Methode wird ein neues Promise zurückgegeben.
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.catch(onRejected)Promise.prototype.catch ruft this.then(undefined, onRejected) auf. Mit der standardmäßigen then-Methode gibt es ein neues Promise zurück, ohne den Zustand des ursprünglichen Promise zu ändern. Der Handler onRejected erhält den Ablehnungsgrund, der kein Error-Objekt sein muss, und wird asynchron ausgeführt, auch wenn das Promise bereits abgelehnt wurde.
Gibt der Handler einen gewöhnlichen Wert zurück, wird das neue Promise mit diesem Wert erfüllt; ohne return ist der Wert undefined. Gibt er ein Promise oder ein Objekt mit einer aufrufbaren then-Methode zurück, übernimmt das neue Promise dessen späteres Ergebnis. Wird ein Fehler ausgelöst, wird das neue Promise abgelehnt. Um einen Fehler weiterzureichen, verwende throw, statt ihn nur auszugeben.
Bei erfülltem Promise wird der Handler übersprungen und der Wert weitergereicht. Ist onRejected keine Funktion, wird auch eine Ablehnung weitergereicht. Ein catch nach then behandelt außerdem Fehler, die in diesem vorherigen Schritt ausgelöst wurden, nicht jedoch Fehler in späteren Schritten oder in unabhängigen asynchronen Vorgängen, die nicht zurückgegeben wurden.
Beispiele
Promise.resolve(10)
.then(() => {
throw new Error("failed");
})
.catch((error) => {
console.log(error.message);
return 42;
})
.then((value) => {
console.log(value);
});
console.log("sync");Ergebnis
sync failed 42
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.