База знанияИзпитен център
BGБългарски
Избери език13

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

Източници