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

CKTIS / JavaScript

Promise.prototype.then — řetězení asynchronních operací

Promise.prototype.then registruje obslužné funkce pro splnění nebo zamítnutí a vrací nový promise. Výsledek obslužné funkce určuje, jak řetězec pokračuje.

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.then(onFulfilled, onRejected)

Promise.prototype.then přijímá nepovinné obslužné funkce onFulfilled a onRejected. První dostane hodnotu splnění, druhá důvod zamítnutí. Volání vrací nový promise. Obslužné funkce se spustí asynchronně po dokončení právě probíhajícího synchronního kódu, a to i tehdy, když už je původní promise vyřešený.

Vrácení běžné hodnoty nový promise splní, zatímco vyhození výjimky jej zamítne. Vrácením promise nebo objektu s volatelnou metodou then nový promise převezme jeho konečný výsledek. Pokud chybí return, výsledkem je undefined. Vracejte asynchronní operace, aby na ně řetězec čekal.

Nevolatelné argumenty se považují za chybějící obslužné funkce: hodnota splnění nebo důvod zamítnutí se předá dál. onRejected nezachytí výjimku vyhozenou funkcí onFulfilled ve stejném volání then; zpracujte ji v pozdějším článku řetězce. Běžné vrácení hodnoty z onRejected může obnovit stav splnění.

Jde o mechanismus ECMAScriptu, nikoli o Web API. Metoda vyžaduje skutečný promise jako this; samotná existence metody then nestačí. Příklad ukazuje odložené zpracování, transformaci hodnoty a zotavení po chybě.

Příklady

console.log('start');

Promise.resolve(3)
  .then(value => value * 2)
  .then(value => {
    console.log(value);
    throw new Error('boom');
  })
  .then(undefined, error => {
    console.log(error.message);
    return 9;
  })
  .then(value => console.log(value));

console.log('end');

Výsledek

start
end
6
boom
9

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