CKTIS / JavaScript
Promise.allSettled — výsledky všech příslibů
Promise.allSettled přijímá iterovatelný objekt a vrací příslib s polem výsledků všech jeho prvků. Zachovává pořadí vstupu a zaznamenává hodnoty splněných příslibů i důvody zamítnutí.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Promise.allSettled(iterable)Promise.allSettled(iterable) je statická metoda dostupná od ECMAScript 2020, nikoli samostatné Web API. Přijímá synchronní iterovatelný objekt, například pole, a jeho prvky zpracovává podle Promise.resolve. Platnými vstupy jsou tedy i běžné hodnoty. Podporu v cílovém prohlížeči je nutné ověřit samostatně; verze Node použité v repozitáři ji nedokazuje.
Vrácený příslib se splní polem, jakmile se všechny prvky dokončí, ať už splněním, nebo zamítnutím. Výsledky odpovídají pořadí vstupu, nikoli pořadí dokončení. Každý výsledek má tvar { status: "fulfilled", value: ... } nebo { status: "rejected", reason: ... }. Než přečtete value nebo reason, zkontrolujte status.
Na rozdíl od Promise.all nezpůsobí zamítnutí jednoho prvku zamítnutí souhrnného příslibu. To však neznamená, že jej tato metoda nemůže zamítnout: zamítnutí může způsobit neplatný vstup, například null, nebo výjimka během iterace. Pokud iterace skončí bez chyby, ale některý prvek se nikdy nedokončí, souhrnný příslib zůstane ve stavu čekání.
U prázdného vstupu je vrácený příslib už splněn hodnotou [], ale funkce předaná do .then se přesto spustí asynchronně. Metoda operace neruší ani neomezuje souběžnost; pouze shromažďuje jejich výsledky.
Příklady
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Výsledek
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.