re:re:actable
Урок 023 минуты чтения

Задача: Promise.allSettled, race и any

На этой странице
Кратко

Три других комбинатора промисов часто дают как продолжение задачи про Promise.all. allSettled ждет все промисы и возвращает массив { status: "fulfilled", value } / { status: "rejected", reason } — никогда не отклоняется. race завершается так же, как первый завершившийся промис (успехом или ошибкой). any выполняется первым успешным результатом и отклоняется AggregateError, только если все отклонились.

Вопрос

Реализуйте promiseAllSettled, promiseRace и promiseAny. Чем они отличаются от Promise.all и где применяются?

allSettled

function promiseAllSettled(iterable) {
  const items = Array.from(iterable);
  return Promise.all(
    items.map((item) =>
      Promise.resolve(item).then(
        (value) => ({ status: "fulfilled", value }),
        (reason) => ({ status: "rejected", reason }),
      ),
    ),
  );
}

Каждый промис превращается в «всегда успешный» с описанием результата, а затем используется Promise.all. Если просят без Promise.all — та же схема со счетчиком, что в задаче про Promise.all, но без reject.

await promiseAllSettled([Promise.resolve(1), Promise.reject(new Error("x")), 3]);
// [
//   { status: "fulfilled", value: 1 },
//   { status: "rejected", reason: Error("x") },
//   { status: "fulfilled", value: 3 }
// ]

race

function promiseRace(iterable) {
  return new Promise((resolve, reject) => {
    for (const item of iterable) {
      Promise.resolve(item).then(resolve, reject);   // первый вызов побеждает, остальные игнорируются
    }
  });
}
await promiseRace([delay(200, "медленный"), delay(50, "быстрый")]);   // "быстрый"
promiseRace([]);   // навсегда pending — как и нативный Promise.race

any

function promiseAny(iterable) {
  return new Promise((resolve, reject) => {
    const items = Array.from(iterable);
    const errors = new Array(items.length);
    let rejected = 0;
 
    if (items.length === 0) {
      reject(new AggregateError([], "All promises were rejected"));
      return;
    }
 
    items.forEach((item, index) => {
      Promise.resolve(item).then(resolve, (error) => {
        errors[index] = error;
        rejected += 1;
        if (rejected === items.length) reject(new AggregateError(errors, "All promises were rejected"));
      });
    });
  });
}
await promiseAny([Promise.reject(new Error("a")), delay(100, "ok")]);   // "ok"
await promiseAny([Promise.reject(new Error("a"))]).catch((e) => e.errors.length); // 1

Сравнение

МетодВыполняетсяОтклоняетсяПустой вход
allвсе успешны → массив значенийпервая ошибка[]
allSettledвсе завершились → массив статусовникогда[]
raceпервый завершившийся успешнопервый завершившийся с ошибкойвечный pending
anyпервый успешныйвсе отклонены → AggregateErrorAggregateError

Применение

ЗадачаМетод
загрузить данные дашборда, где виджеты независимыallSettled — показать то, что загрузилось
таймаут запросаrace([fetch(url), timeout(5000)])
взять ответ с самого быстрого зеркала / CDNany
все данные обязательны для экранаall

Что важно помнить

  • race с таймаутом не отменяет исходный запрос — используйте AbortSignal.timeout.
  • any отклоняется AggregateError с массивом errors.
  • allSettled удобен для массовых операций с отчетом об ошибках.
  • Теория: Promise.all, allSettled, race и any.

Мини-шпаргалка

allSettled — каждый промис → { status, value | reason }, затем all. race — Promise.resolve(x).then(resolve, reject) для всех, побеждает первый. any — resolve первым успехом, счетчик ошибок → AggregateError. Пустой race — pending, пустой any — AggregateError.

Документация

MDN: Promise.allSettled(), MDN: Promise.race(), MDN: Promise.any(), MDN: AggregateError.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам