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: 0Druhý 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