CKTIS / JavaScript
Promise.prototype.finally — Aufräumen nach dem Abschluss eines Promise
Promise.prototype.finally führt eine Funktion aus, nachdem ein Promise erfüllt oder abgelehnt wurde. Es ermöglicht gemeinsames Aufräumen und erhält normalerweise das ursprüngliche Ergebnis; ein Fehler beim Aufräumen kann es jedoch ersetzen.
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.finally(onFinally)Promise.prototype.finally registriert onFinally, das asynchron aufgerufen wird, nachdem das Promise erfüllt oder abgelehnt wurde. Die Funktion erhält keine Argumente: weder den Wert noch den Ablehnungsgrund. Bei standardmäßigen Promises gibt die Methode ein neues Promise zurück, ohne das ursprüngliche zu ändern.
Ein gewöhnlicher Rückgabewert von onFinally wird ignoriert. Wird die Funktion erfolgreich abgeschlossen, behält die Kette den ursprünglichen Wert oder Ablehnungsgrund bei. Gibt sie ein Promise oder Thenable zurück, wartet die Kette auf dessen Auflösung. Eine ausgelöste Ausnahme oder Ablehnung ersetzt das ursprüngliche Ergebnis durch eine neue Ablehnung; bleibt die Verarbeitung dauerhaft ausstehend, wird die nachfolgende Kette blockiert.
Das ist nicht gleichbedeutend mit then(onFinally, onFinally): Diese Funktionen erhalten ein Argument, und ihr Ergebnis kann den vorherigen Wert ersetzen. finally() behandelt einen Fehler nicht selbst — verwende catch() für die zurückgegebene Kette. Ein Argument, das keine Funktion ist, wird von der standardmäßigen Promise-Verarbeitung ignoriert.
Die Methode gehört seit ES2018 zu ECMAScript, nicht zu den Web APIs. Die Sprachspezifikation bestätigt nicht die Unterstützung in einem bestimmten Browser; auch Node 24 in einem Repository beweist sie nicht. Im Beispiel ersetzt "ignored" nicht 42, und das zweite Aufräumen beseitigt die Ablehnung nicht.
Beispiele
Promise.resolve(42)
.finally(() => {
console.log("cleanup");
return "ignored";
})
.then((value) => {
console.log(value);
return Promise.reject("failure");
})
.finally(() => {
console.log("cleanup after rejection");
})
.catch((reason) => console.log(reason));Ergebnis
cleanup 42 cleanup after rejection failure
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.