CKTIS / JavaScript
Записи с резултати от Promise.allSettled()
`Promise.allSettled()` връща обещание, което след приключването на всички входни обещания се изпълнява с масив от резултати в реда на входа. `status` показва дали да прочетеш `value`, или `reason`.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
Promise.allSettled(iterable)
// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }Promise.allSettled(iterable) е статичен метод на Promise, който приема синхронно итерируем обект, например масив. Той обработва всеки елемент като Promise.resolve(): възприема изхода на обектите от тип thenable и използва обикновените стойности като стойности при изпълнение. Когато всички входни обещания са изпълнени или отхвърлени, върнатото обещание се изпълнява с масив с по един резултат за всеки елемент, в реда на обхождане, а не на приключване.
Всеки запис с резултат е обикновен обект на JavaScript. При status: "fulfilled" той има собствено свойство value, но няма собствено свойство reason. При status: "rejected" има собствено свойство reason, но няма собствено свойство value. Първо провери status: 0 и undefined могат да бъдат валидни стойности при изпълнение, а причината за отхвърлянето не е задължително да е обект Error и също може да е undefined.
За разлика от Promise.all(), отделното отхвърляне се записва в масива и само по себе си не отхвърля общото обещание. Така можеш да запазиш успешните резултати от независими задачи и да обработиш неуспехите отделно. Грешка при обхождането на итерируемия обект все пак може да отхвърли общото обещание, вместо да създаде запис с резултат.
При празен вход методът връща обещание, което вече е изпълнено с [], но функцията, подадена на .then(), все пак се извиква асинхронно. При непразен вход и стандартно поведение на обещанията общото обещание все още е в изчакване, когато методът го върне, дори ако вече няма чакащи входни обещания. То обаче може вече да е изпълнено при връщането, ако единственият входен елемент е нативно обещание, което Promise.resolve() връща без промяна и чийто собствен метод then синхронно извиква функцията за обработка на изпълнението.
Примери
{
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}`);
}
}
});
}Резултат
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0Второто обещание се отхвърля, преди първото да се изпълни, но записът му остава на второ място. Обикновената стойност `0` дава запис със състояние `"fulfilled"`.
Свързани уроци
- JavaScript · Урок 15 · Средно · Версия: 3