Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori