CKTIS / JavaScript
Promise.allSettled — ishodi svih obećanja
Promise.allSettled prihvaća iterabilni objekt i vraća obećanje s poljem ishoda svih elemenata. Zadržava redoslijed ulaza te bilježi i ispunjene vrijednosti i razloge odbijanja.
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.allSettled(iterable)Promise.allSettled(iterable) statička je metoda dostupna od ECMAScript 2020., a ne zaseban Web API. Prihvaća sinkroni iterabilni objekt, primjerice polje, i obrađuje njegove elemente prema Promise.resolve. Stoga su i obične vrijednosti valjani ulazi. Podršku u ciljnom pregledniku treba provjeriti zasebno; verzija Nodea koja se upotrebljava u repozitoriju ne dokazuje tu podršku.
Vraćeno obećanje ispunjava se poljem kada se svi elementi razriješe, bilo ispunjenjem ili odbijanjem. Ishodi slijede redoslijed ulaza, a ne redoslijed dovršetka. Svaki ishod ima oblik { status: "fulfilled", value: ... } ili { status: "rejected", reason: ... }. Prije čitanja value ili reason provjeri status.
Za razliku od Promise.all, odbijanje pojedinog elementa ne odbija zbirno obećanje. To ipak ne znači da ga ova metoda nikada ne može odbiti: nevaljan ulaz, primjerice null, ili iznimka tijekom iteracije mogu uzrokovati odbijanje. Ako iteracija završi bez pogreške, ali se neki element nikada ne razriješi, zbirno obećanje ostaje na čekanju.
Kod praznog ulaza vraćeno je obećanje već ispunjeno s [], ali funkcija predana u .then svejedno se izvršava asinkrono. Metoda ne otkazuje operacije niti ograničava istodobnost; prikuplja njihove ishode.
Primjeri
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}]Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.