CKTIS / JavaScript
Promise.prototype.finally — úklid po dokončení příslibu
Promise.prototype.finally spustí funkci poté, co je příslib splněn nebo zamítnut. Umožňuje společný úklid, který obvykle zachová původní výsledek, ale chyba při úklidu ho může nahradit.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
promise.finally(onFinally)Promise.prototype.finally zaregistruje onFinally, který se zavolá asynchronně poté, co je příslib splněn nebo zamítnut. Funkce nedostane žádné argumenty: ani hodnotu, ani důvod zamítnutí. U standardních příslibů metoda vrací nový příslib, aniž by změnila původní.
Běžná hodnota vrácená z onFinally se ignoruje. Pokud funkce úspěšně skončí, řetězec zachová původní hodnotu nebo důvod zamítnutí. Pokud vrátí příslib nebo thenable, řetězec čeká na jeho vyřešení. Vyvolaná výjimka nebo zamítnutí nahradí původní výsledek novým zamítnutím; pokud zůstane navždy nevyřešený, zablokuje pokračování řetězce.
To není totéž co then(onFinally, onFinally): tyto funkce dostávají argument a jejich výsledek může nahradit předchozí hodnotu. finally() samo chybu nezpracuje — na vráceném řetězci použijte catch(). Standardní zpracování příslibů ignoruje argument, který není funkcí.
Metoda je součástí ECMAScriptu od ES2018, nikoli Web APIs. Jazyková specifikace nepotvrzuje podporu v konkrétním prohlížeči; ani přítomnost Node 24 v repozitáři ji nedokazuje. V příkladu "ignored" nenahradí 42 a druhý úklid neodstraní zamítnutí.
Příklady
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));Výsledek
cleanup 42 cleanup after rejection failure
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.