CKTIS / JavaScript
Promise.allSettled — výsledky všetkých prísľubov
Promise.allSettled prijíma iterovateľný objekt a vracia prísľub s poľom výsledkov všetkých jeho prvkov. Zachováva poradie vstupu a zaznamenáva hodnoty splnených prísľubov aj dôvody zamietnutia.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Promise.allSettled(iterable)Promise.allSettled(iterable) je statická metóda dostupná od ECMAScript 2020, nie samostatné Web API. Prijíma synchrónny iterovateľný objekt, napríklad pole, a jeho prvky spracúva podľa Promise.resolve. Platnými vstupmi sú teda aj obyčajné hodnoty. Podporu v cieľovom prehliadači treba overiť osobitne; verzia Node použitá v repozitári ju nedokazuje.
Vrátený prísľub sa splní poľom, keď sa dokončia všetky prvky, či už splnením, alebo zamietnutím. Výsledky zodpovedajú poradiu vstupu, nie poradiu dokončenia. Každý výsledok má tvar { status: "fulfilled", value: ... } alebo { status: "rejected", reason: ... }. Pred čítaním value alebo reason skontrolujte status.
Na rozdiel od Promise.all zamietnutie jedného prvku nespôsobí zamietnutie súhrnného prísľubu. To však neznamená, že ho táto metóda nemôže zamietnuť: neplatný vstup, napríklad null, alebo výnimka počas iterácie môže spôsobiť zamietnutie. Ak iterácia prebehne bez chyby, ale niektorý prvok sa nikdy nedokončí, súhrnný prísľub zostane v stave čakania.
Pri prázdnom vstupe je vrátený prísľub už splnený hodnotou [], ale funkcia odovzdaná do .then sa napriek tomu vykoná asynchrónne. Metóda operácie neruší ani neobmedzuje súbežnosť; zhromažďuje ich výsledky.
Príklady
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Výsledok
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.