CKTIS / JavaScript
Promise.prototype.finally — čišćenje nakon dovršetka obećanja
Promise.prototype.finally pokreće funkciju nakon što se obećanje ispuni ili odbije. Omogućuje zajedničko čišćenje koje obično čuva izvorni ishod, no pogreška tijekom čišćenja može ga zamijeniti.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
promise.finally(onFinally)Promise.prototype.finally registrira onFinally, koji se poziva asinkrono nakon što se obećanje ispuni ili odbije. Funkcija ne prima argumente: ni vrijednost ni razlog odbijanja. Za standardna obećanja metoda vraća novo obećanje, a izvorno ne mijenja.
Obična povratna vrijednost funkcije onFinally zanemaruje se. Ako funkcija uspješno završi, lanac čuva izvornu vrijednost ili razlog odbijanja. Ako vrati obećanje ili thenable, lanac čeka da se ono razriješi. Izbačena iznimka ili odbijanje zamjenjuje izvorni ishod novim odbijanjem; ako ostane neriješeno zauvijek, blokira nastavak lanca.
To nije isto što i then(onFinally, onFinally): te funkcije primaju argument, a njihov rezultat može zamijeniti prethodnu vrijednost. finally() sam ne obrađuje pogrešku — upotrijebi catch() na vraćenom lancu. Standardna obrada obećanja zanemaruje argument koji nije funkcija.
Metoda je dio ECMAScripta od ES2018, a ne Web APIs. Jezična specifikacija ne potvrđuje podršku u određenom pregledniku; ne dokazuje je ni prisutnost Node 24 u repozitoriju. U primjeru "ignored" ne zamjenjuje 42, a drugo čišćenje ne uklanja odbijanje.
Primjeri
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));Rezultat
cleanup 42 cleanup after rejection failure
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.