CKTIS / JavaScript
Promise.prototype.then — reťazenie asynchrónnych operácií
Promise.prototype.then registruje obslužné funkcie pre splnenie alebo zamietnutie a vracia nový promise. Výsledok obslužnej funkcie určuje, ako reťazec pokračuje.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
promise.then(onFulfilled, onRejected)Promise.prototype.then prijíma voliteľné obslužné funkcie onFulfilled a onRejected. Prvá dostane hodnotu splnenia, druhá dôvod zamietnutia. Volanie vracia nový promise. Obslužné funkcie sa vykonajú asynchrónne po skončení práve prebiehajúceho synchrónneho kódu, aj keď už je pôvodný promise vyriešený.
Vrátenie bežnej hodnoty nový promise splní, zatiaľ čo vyhodenie výnimky ho zamietne. Vrátením promise alebo objektu s volateľnou metódou then nový promise prevezme jeho konečný výsledok. Ak chýba return, výsledkom je undefined. Vracajte asynchrónne operácie, aby na ne reťazec počkal.
Nevolateľné argumenty sa považujú za chýbajúce obslužné funkcie: hodnota splnenia alebo dôvod zamietnutia sa odovzdá ďalej. onRejected nezachytí výnimku vyhodenú funkciou onFulfilled v tom istom volaní then; spracujte ju v neskoršom článku reťazca. Bežné vrátenie hodnoty z onRejected môže obnoviť stav splnenia.
Ide o mechanizmus ECMAScriptu, nie o Web API. Metóda vyžaduje skutočný promise ako this; samotná existencia metódy then nestačí. Príklad ukazuje odložené spracovanie, transformáciu hodnoty a zotavenie po chybe.
Prí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ýsledok
start end 6 boom 9
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.