CKTIS / JavaScript
Promise.prototype.finally — upratanie po dokončení prísľubu
Promise.prototype.finally spustí funkciu po splnení alebo zamietnutí prísľubu. Umožňuje spoločné upratanie, ktoré zvyčajne zachová pôvodný výsledok, no chyba pri uprataní ho môže nahradiť.
Verzia: 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 zaregistruje onFinally, ktorý sa zavolá asynchrónne po splnení alebo zamietnutí prísľubu. Funkcia nedostane žiadne argumenty: ani hodnotu, ani dôvod zamietnutia. Pri štandardných prísľuboch metóda vráti nový prísľub bez zmeny pôvodného.
Bežná hodnota vrátená z onFinally sa ignoruje. Ak sa funkcia úspešne skončí, reťazec zachová pôvodnú hodnotu alebo dôvod zamietnutia. Ak vráti prísľub alebo thenable, reťazec čaká na jeho vyriešenie. Vyvolaná výnimka alebo zamietnutie nahradí pôvodný výsledok novým zamietnutím; ak zostane navždy nevyriešený, zablokuje pokračovanie reťazca.
Nie je to to isté ako then(onFinally, onFinally): tieto funkcie dostávajú argument a ich výsledok môže nahradiť predchádzajúcu hodnotu. finally() samo chybu nespracuje — na vrátenom reťazci použite catch(). Štandardné spracovanie prísľubov ignoruje argument, ktorý nie je funkciou.
Metóda je súčasťou ECMAScriptu od ES2018, nie Web APIs. Jazyková špecifikácia nepotvrdzuje podporu v konkrétnom prehliadači; nedokazuje ju ani prítomnosť Node 24 v repozitári. V príklade "ignored" nenahradí 42 a druhé upratanie neodstráni zamietnutie.
Prí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ýsledok
cleanup 42 cleanup after rejection failure
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.