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

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.

Viri