Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Promise.all — en skupni rezultat več obljub

Promise.all vrne eno obljubo za vse elemente iterabilnega objekta. Če se iteracija konča brez napak in vsi elementi vrnejo vrednost, se obljuba izpolni s poljem rezultatov v vrstnem redu vhodnih elementov. Ob prvi zaznani zavrnitvi vhodne obljube je skupna obljuba zavrnjena. Zavrne se lahko tudi zaradi izjeme, sprožene med iteracijo, čeprav ni zavrnjena nobena vhodna obljuba. Metoda preostalih operacij ne prekliče.

Različica: 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) je statična metoda, ki sprejme sinhroni iterabilni objekt, na primer polje. Vrne novo obljubo, izpolnjeno s poljem vrednosti, ko vsi elementi uspejo. Navadne vrednosti so dovoljene; objekti s klicljivo metodo then se prevzamejo kot obljube.

Vrstni red rezultatov sledi vrstnemu redu vnosa, ne vrstnemu redu zaključevanja operacij. Prazen vhod ustvari obljubo, ki je že izpolnjena z []; povratne funkcije, posredovane v .then(), se kljub temu izvedejo asinhrono. Pri nepraznem vhodu z navadnimi vrednostmi ali izpolnjenimi obljubami je asinhrona tudi izpolnitev rezultata.

Prva zaznana zavrnitev zavrne združeno obljubo z istim razlogom, ne da bi čakala na uspeh drugih. To njihovega dela ne prekliče. Zavrnitev obravnavajte z .catch() ali z try/catch okoli await. Metoda podanih funkcij ne pokliče: če želite zbrati njihove rezultate, jih pokličite in posredujte vrnjene obljube.

V primeru se first izpolni za second, rezultat pa kljub temu ohrani vrstni red vnosa. Število 3 se v polju pojavi nespremenjeno, sync pa se izpiše pred rezultatom.

Primeri

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]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri