Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje