Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Promise.prototype.finally — úklid po dokončení příslibu

Promise.prototype.finally spustí funkci poté, co je příslib splněn nebo zamítnut. Umožňuje společný úklid, který obvykle zachová původní výsledek, ale chyba při úklidu ho může nahradit.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

promise.finally(onFinally)

Promise.prototype.finally zaregistruje onFinally, který se zavolá asynchronně poté, co je příslib splněn nebo zamítnut. Funkce nedostane žádné argumenty: ani hodnotu, ani důvod zamítnutí. U standardních příslibů metoda vrací nový příslib, aniž by změnila původní.

Běžná hodnota vrácená z onFinally se ignoruje. Pokud funkce úspěšně skončí, řetězec zachová původní hodnotu nebo důvod zamítnutí. Pokud vrátí příslib nebo thenable, řetězec čeká na jeho vyřešení. Vyvolaná výjimka nebo zamítnutí nahradí původní výsledek novým zamítnutím; pokud zůstane navždy nevyřešený, zablokuje pokračování řetězce.

To není totéž co then(onFinally, onFinally): tyto funkce dostávají argument a jejich výsledek může nahradit předchozí hodnotu. finally() samo chybu nezpracuje — na vráceném řetězci použijte catch(). Standardní zpracování příslibů ignoruje argument, který není funkcí.

Metoda je součástí ECMAScriptu od ES2018, nikoli Web APIs. Jazyková specifikace nepotvrzuje podporu v konkrétním prohlížeči; ani přítomnost Node 24 v repozitáři ji nedokazuje. V příkladu "ignored" nenahradí 42 a druhý úklid neodstraní zamítnutí.

Pří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ýsledek

cleanup
42
cleanup after rejection
failure

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje