Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje