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.