CKTIS / JavaScript
Záznamy výsledkov Promise.allSettled()
`Promise.allSettled()` vracia prísľub, ktorý sa po dokončení všetkých vstupných prísľubov splní s poľom výsledkov v poradí vstupu. Podľa `status` zistíš, či čítať `value` alebo `reason`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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á metóda objektu Promise, ktorá prijíma synchrónne iterovateľný objekt, napríklad pole. Každú položku spracuje ako Promise.resolve(): preberie výsledok objektov typu thenable a obyčajnú hodnotu použije ako hodnotu splnenia. Po splnení alebo zamietnutí všetkých vstupných prísľubov sa vrátený prísľub splní s poľom obsahujúcim jeden výsledok na položku, v poradí iterácie, nie v poradí dokončenia.
Každý záznam je obyčajný objekt JavaScriptu. Pri status: "fulfilled" má vlastnú vlastnosť value, ale nemá vlastnú vlastnosť reason. Pri status: "rejected" má vlastnú vlastnosť reason, ale nemá vlastnú vlastnosť value. Najprv skontroluj status: 0 aj undefined môžu byť platné hodnoty splnenia. Dôvod zamietnutia nemusí byť objekt Error a môže byť aj undefined.
Na rozdiel od Promise.all() sa jednotlivé zamietnutie zaznamená do poľa a samo osebe nespôsobí zamietnutie súhrnného prísľubu. Môžeš tak zachovať úspešné výsledky nezávislých úloh a neúspechy spracovať samostatne. Chyba pri čítaní iterovateľného objektu však môže spôsobiť zamietnutie súhrnného prísľubu namiesto vytvorenia záznamu výsledku.
Pri prázdnom vstupe metóda vráti prísľub už splnený s hodnotou [], ale funkcia odovzdaná metóde .then() sa aj tak vykoná asynchrónne. Pri neprázdnom vstupe a štandardnom správaní prísľubov súhrnný prísľub v okamihu návratu z metódy ešte čaká na dokončenie, aj keď už žiadny vstupný prísľub nečaká. Môže však byť splnený už pri návrate, ak je jedinou vstupnou položkou natívny prísľub, ktorý Promise.resolve() vráti bez zmeny a ktorého vlastná metóda then synchrónne zavolá funkciu pre prípad splnenia.
Prí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ýsledok
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0Druhý prísľub sa zamietne skôr, než sa splní prvý, ale jeho záznam zostáva na druhom mieste. Obyčajná hodnota `0` vytvorí záznam so stavom `"fulfilled"`.
Súvisiace lekcie
- JavaScript · Lekcia 15 · Stredne pokročilá · Verzia: 3