CKTIS / JavaScript
Promise.all — jeden výsledok z viacerých prísľubov
Promise.all vráti jeden prísľub pre všetky prvky iterovateľného objektu. Ak sa iterácia skončí bez chyby a všetky prvky poskytnú hodnotu, prísľub sa splní s poľom výsledkov v poradí vstupu. Pri prvom zaznamenanom zamietnutí vstupného prísľubu sa spoločný prísľub zamietne. K jeho zamietnutiu môže viesť aj výnimka vyvolaná počas iterácie, a to aj vtedy, keď sa žiadny vstupný prísľub nezamietne. Metóda ostatné operácie nezruší.
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.all(iterable)Promise.all(iterable) je statická metóda, ktorá prijíma synchrónny iterovateľný objekt, napríklad pole. Vráti nový prísľub splnený poľom hodnôt, keď všetky prvky uspejú. Bežné hodnoty sú povolené; objekty s volateľnou metódou then sa prevezmú ako prísľuby.
Poradie výsledkov zodpovedá poradiu vstupu, nie poradiu dokončenia operácií. Prázdny vstup vytvorí prísľub už splnený hodnotou []; funkcie spätného volania odovzdané do .then() sa napriek tomu vykonajú asynchrónne. Pri neprázdnom vstupe s bežnými hodnotami alebo splnenými prísľubmi je asynchrónne aj splnenie výsledku.
Prvé zaznamenané zamietnutie zamietne spoločný prísľub s rovnakým dôvodom bez čakania na úspech ostatných. Ich prácu to nezruší. Zamietnutia ošetrite pomocou .catch() alebo pomocou try/catch okolo await. Metóda odovzdané funkcie nevolá: ak chcete zhromaždiť ich výsledky, zavolajte ich a odovzdajte vrátené prísľuby.
V príklade sa first splní po second, no výsledok zachováva poradie vstupu. Číslo 3 sa v poli objaví bez zmeny a sync sa vypíše pred výsledkom.
Príklady
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Výsledok
sync ["A","B",3]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.