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

CKTIS / JavaScript

Záznamy výsledků Promise.allSettled()

`Promise.allSettled()` vrací příslib, který se po dokončení všech vstupních příslibů splní s polem výsledků v pořadí vstupu. Podle `status` poznáš, zda číst `value`, nebo `reason`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

Promise.allSettled(iterable)

// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }

Promise.allSettled(iterable) je statická metoda objektu Promise. Přijímá synchronně iterovatelný objekt, například pole. S každou položkou zachází jako Promise.resolve(): přebírá výsledek objektů typu thenable a obyčejnou hodnotu použije jako hodnotu splnění. Po splnění nebo zamítnutí všech vstupních příslibů se vrácený příslib splní s polem obsahujícím jeden výsledek na položku, v pořadí iterace, nikoli v pořadí dokončení.

Každý záznam je obyčejný objekt JavaScriptu. Při status: "fulfilled" má vlastní vlastnost value, ale nemá vlastní vlastnost reason. Při status: "rejected" má vlastní vlastnost reason, ale nemá vlastní vlastnost value. Nejprve zkontroluj status: 0 i undefined mohou být platné hodnoty splnění. Důvod zamítnutí nemusí být objekt Error a může být také undefined.

Na rozdíl od Promise.all() se jednotlivé zamítnutí zaznamená do pole a samo o sobě nezamítne souhrnný příslib. Díky tomu můžeš zachovat úspěšné výsledky nezávislých úloh a neúspěchy zpracovat zvlášť. Chyba při čtení iterovatelného objektu však může vést k zamítnutí souhrnného příslibu, místo aby vznikl záznam výsledku.

Při prázdném vstupu metoda vrací příslib už splněný s hodnotou [], ale funkce předaná metodě .then() se i tak spustí asynchronně. Při neprázdném vstupu a standardním chování příslibů souhrnný příslib při návratu z metody ještě čeká na dokončení, i když už žádný vstupní příslib nečeká. Může však být splněný už při návratu, pokud je jedinou vstupní položkou nativní příslib, který Promise.resolve() vrátí beze změny a jehož vlastní metoda then synchronně zavolá funkci pro případ splnění.

Příklady

{
  let finishFirst;
  const first = new Promise((resolve) => { finishFirst = resolve; });
  const second = Promise.reject("offline");
  const batch = Promise.allSettled([first, second, 0]);
  finishFirst("profile");

  batch.then((results) => {
    console.log(JSON.stringify(results));
    for (const result of results) {
      if (result.status === "fulfilled") {
        console.log(`value: ${result.value}`);
      } else {
        console.log(`reason: ${result.reason}`);
      }
    }
  });
}

Výsledek

[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0

Druhý příslib se zamítne dřív, než se splní první, ale jeho záznam zůstane na druhém místě. Obyčejná hodnota `0` vytvoří záznam se stavem `"fulfilled"`.

Související lekce

  • JavaScript · Lekce 15 · Středně pokročilá · Verze: 3

Zdroje