CKTIS / JavaScript
Promise.prototype.finally — sprzątanie po zakończeniu obietnicy
Promise.prototype.finally uruchamia funkcję po spełnieniu lub odrzuceniu obietnicy. Służy do wspólnego sprzątania: zwykle zachowuje pierwotny wynik, ale błąd funkcji sprzątającej może go zastąpić.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
promise.finally(onFinally)Promise.prototype.finally rejestruje onFinally, wywoływane asynchronicznie po spełnieniu albo odrzuceniu obietnicy. Funkcja nie otrzymuje argumentów: ani wartości, ani powodu odrzucenia. Dla standardowych obietnic metoda zwraca nową obietnicę, nie zmieniając oryginalnej.
Zwykła wartość zwrócona przez onFinally jest ignorowana. Jeśli funkcja zakończy się poprawnie, dalszy łańcuch zachowuje pierwotną wartość albo powód odrzucenia. Gdy zwróci obietnicę lub obiekt thenable, łańcuch czeka na jego rozstrzygnięcie. Rzucony wyjątek lub odrzucenie zastępuje pierwotny wynik nowym odrzuceniem; oczekiwanie bez końca blokuje dalszy łańcuch.
To nie jest odpowiednik then(onFinally, onFinally): tam funkcje otrzymują argument, a ich wynik może zastąpić wcześniejszą wartość. finally() samo nie obsługuje błędu — użyj catch() na zwróconym łańcuchu. Argument niebędący funkcją jest pomijany przez standardową obsługę obietnic.
Metoda należy do ECMAScript od ES2018, nie do Web APIs. Specyfikacja języka nie potwierdza wsparcia konkretnej przeglądarki; obecność Node 24 w repozytorium także go nie dowodzi. W przykładzie "ignored" nie zastępuje 42, a drugie sprzątanie nie usuwa odrzucenia.
Przykłady
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));Wynik
cleanup 42 cleanup after rejection failure
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.