CKTIS / JavaScript
Promise.all — jeden výsledek z více příslibů
Promise.all vrací jeden příslib pro všechny prvky iterovatelného objektu. Pokud iterace skončí bez chyby a všechny prvky poskytnou hodnotu, příslib se splní s polem výsledků v pořadí vstupu. Při prvním zaznamenaném zamítnutí vstupního příslibu se společný příslib zamítne. K jeho zamítnutí může vést i výjimka vyvolaná během iterace, a to i tehdy, když se žádný vstupní příslib nezamítne. Metoda ostatní operace neruší.
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.all(iterable)Promise.all(iterable) je statická metoda, která přijímá synchronní iterovatelný objekt, například pole. Vrací nový příslib splněný polem hodnot, jakmile všechny prvky uspějí. Běžné hodnoty jsou přijímány; objekty s volatelnou metodou then jsou převzaty jako přísliby.
Pořadí výsledků odpovídá pořadí vstupu, nikoli pořadí dokončení operací. Prázdný vstup vytvoří příslib již splněný hodnotou []; funkce zpětného volání předané do .then() se přesto spustí asynchronně. U neprázdného vstupu obsahujícího běžné hodnoty nebo splněné přísliby je asynchronní i splnění výsledku.
První zaznamenané zamítnutí zamítne společný příslib se stejným důvodem, aniž by čekal na úspěch ostatních. Tím se jejich práce nezruší. Zamítnutí ošetřete pomocí .catch() nebo pomocí try/catch kolem await. Metoda předané funkce nevolá: chcete-li shromáždit jejich výsledky, zavolejte je a předejte vrácené přísliby.
V příkladu se first splní až po second, ale výsledek zachovává pořadí vstupu. Číslo 3 se v poli objeví beze změny a sync se vypíše před výsledkem.
Pří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ýsledek
sync ["A","B",3]
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.