CKTIS / JavaScript
Promise.allSettled — izidi vseh obljub
Promise.allSettled sprejme iterabilni objekt in vrne obljubo, ki se izpolni s poljem izidov vseh elementov. Ohrani vrstni red vhoda ter zabeleži tako izpolnjene vrednosti kot razloge za zavrnitev.
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.allSettled(iterable)Promise.allSettled(iterable) je statična metoda, ki je na voljo od ECMAScript 2020, in ne ločen spletni API. Sprejme sinhroni iterabilni objekt, na primer polje, in njegove elemente obdela v skladu z Promise.resolve. Zato so veljaven vhod tudi navadne vrednosti. Podporo v ciljnem brskalniku je treba preveriti ločeno; različica Node, uporabljena v repozitoriju, je ne dokazuje.
Vrnjena obljuba se izpolni s poljem izidov, ko so vsi elementi zaključeni, bodisi z izpolnitvijo bodisi z zavrnitvijo. Izidi sledijo vrstnemu redu vhoda, ne vrstnemu redu zaključevanja. Vsak izid je oblike { status: "fulfilled", value: ... } ali { status: "rejected", reason: ... }. Pred branjem value ali reason preveri status.
V nasprotju z Promise.all zavrnitev posameznega elementa ne zavrne združene obljube. To pa ne pomeni, da je metoda nikoli ne more zavrniti: neveljaven vhod, na primer null, ali izjema med iteracijo lahko povzročita zavrnitev. Če se iteracija konča brez napake, kateri od elementov pa se nikoli ne zaključi, združena obljuba ostane v stanju čakanja.
Pri praznem vhodu je vrnjena obljuba že izpolnjena z [], vendar se funkcija, predana v .then, še vedno izvede asinhrono. Metoda operacij ne prekliče in ne omejuje sočasnosti; zbira njihove izide.
Primeri
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Rezultat
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.