CKTIS / JavaScript
Promise.prototype.finally — čiščenje po zaključku obljube
Promise.prototype.finally izvede funkcijo, ko je obljuba izpolnjena ali zavrnjena. Omogoča skupno čiščenje, ki običajno ohrani prvotni izid, vendar ga lahko napaka med čiščenjem nadomesti.
Različica: 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, ki se asinhrono pokliče, ko je obljuba izpolnjena ali zavrnjena. Funkcija ne prejme argumentov: ne vrednosti ne razloga za zavrnitev. Pri standardnih obljubah metoda vrne novo obljubo, ne da bi spremenila izvirno.
Običajna vrednost, ki jo vrne onFinally, se prezre. Če se funkcija uspešno konča, veriga ohrani prvotno vrednost ali razlog za zavrnitev. Če vrne obljubo ali thenable, veriga počaka na njeno razrešitev. Izjema ali zavrnitev nadomesti prvotni izid z novo zavrnitvijo; če obljuba ostane za vedno čakajoča, blokira nadaljevanje verige.
To ni enakovredno then(onFinally, onFinally): ti funkciji prejmeta argument, njun rezultat pa lahko nadomesti prejšnjo vrednost. finally() sam ne obravnava napake — na vrnjeni verigi uporabi catch(). Standardna obravnava obljub prezre argument, ki ni funkcija.
Metoda je del ECMAScript od ES2018, ne Web APIs. Jezikovna specifikacija ne potrjuje podpore v določenem brskalniku; tega ne dokazuje niti prisotnost Node 24 v repozitoriju. V primeru "ignored" ne nadomesti 42, drugo čiščenje pa ne odpravi zavrnitve.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.