CKTIS / JavaScript
Promise.all — zajednički rezultat više obećanja
Promise.all vraća jedno obećanje za sve elemente iterabilnog objekta. Ako iteracija završi bez pogreške i svi elementi daju vrijednost, obećanje se ispunjava nizom rezultata u redoslijedu ulaznih elemenata. Pri prvom uočenom odbijanju ulaznog obećanja odbija se i zajedničko obećanje. Do njegova odbijanja može dovesti i iznimka bačena tijekom iteracije, čak i ako nijedno ulazno obećanje nije odbijeno. Metoda ne otkazuje preostale operacije.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Promise.all(iterable)Promise.all(iterable) statička je metoda koja prihvaća sinkroni iterabilni objekt, primjerice niz. Vraća novo obećanje ispunjeno nizom vrijednosti kada svi elementi uspiju. Obične vrijednosti su dopuštene; objekti s pozivljivom metodom then preuzimaju se kao obećanja.
Redoslijed rezultata prati redoslijed ulaza, a ne redoslijed dovršetka operacija. Prazan ulaz daje obećanje koje je već ispunjeno vrijednošću []; povratne funkcije proslijeđene u .then() ipak se izvršavaju asinkrono. Kod nepraznog ulaza koji sadrži obične vrijednosti ili ispunjena obećanja, i ispunjenje rezultata je asinkrono.
Prvo uočeno odbijanje odbija objedinjeno obećanje s istim razlogom, bez čekanja da ostala uspiju. To ne otkazuje njihov rad. Odbijanje obradi pomoću .catch() ili pomoću try/catch oko await. Metoda ne poziva zadane funkcije: da bi prikupio njihove rezultate, pozovi ih i proslijedi vraćena obećanja.
U primjeru se first ispunjava nakon second, ali rezultat zadržava redoslijed ulaza. Broj 3 pojavljuje se nepromijenjen u nizu, a sync se ispisuje prije rezultata.
Primjeri
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");Rezultat
sync ["A","B",3]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.