Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri