Promise.all, race, allSettled, any
Комбинаторы промисов: Promise.all, allSettled, race, any и Promise.withResolvers — как запускать операции параллельно и собирать результаты.
Зачем нужны комбинаторы
Независимые операции выгодно запускать параллельно, а не одну за другой. Комбинаторы принимают итерируемый набор промисов (обычно массив) и возвращают один промис. Ниже все примеры используют такую вспомогательную функцию:
const delay = (ms, value, fail = false) =>
new Promise((resolve, reject) =>
setTimeout(() => (fail ? reject(new Error(value)) : resolve(value)), ms));
Promise.all
Ждёт всех. Результат — массив значений в том же порядке, что и вход (а не в порядке завершения). Не-промисы в массиве считаются готовыми значениями. Если хотя бы один промис отклонён, all сразу отклоняется с этой ошибкой (fail-fast), не дожидаясь остальных:
console.log(await Promise.all([delay(30, "a"), delay(10, "b"), 3]));
try {
await Promise.all([delay(30, "a"), delay(10, "сбой", true)]);
} catch (e) { console.log("all упал:", e.message); }
[ 'a', 'b', 3 ]
all упал: сбой
Остальные операции при этом не отменяются — просто их результат уже никому не нужен.
Promise.allSettled
Ждёт завершения всех и никогда не отклоняется. Для каждого промиса возвращает объект со статусом:
console.log(await Promise.allSettled([delay(10, "ok"), delay(5, "плохо", true)]));
[
{ status: 'fulfilled', value: 'ok' },
{ status: 'rejected', reason: Error: плохо ... } // здесь Node.js печатает ещё и стек
]
Идеален, когда нужен отчёт по всем операциям: например, загрузить пять картинок и показать, какие не удались.
Promise.race
Возвращает результат первого завершившегося промиса — неважно, успешно или с ошибкой:
console.log(await Promise.race([delay(30, "медленный"), delay(10, "быстрый")]));
try { await Promise.race([delay(30, "медленный"), delay(10, "быстрая ошибка", true)]); }
catch (e) { console.log("race:", e.message); }
быстрый
race: быстрая ошибка
Классическое применение — таймаут: Promise.race([запрос, rejectAfter(5000)]).
Promise.any
Возвращает первый успешный результат, игнорируя ошибки. Если отклонены все, получаем AggregateError со списком причин в свойстве errors:
console.log(await Promise.any([delay(5, "e1", true), delay(20, "победил")]));
try { await Promise.any([delay(5, "e1", true), delay(10, "e2", true)]); }
catch (e) { console.log(e.constructor.name, e.message, e.errors.map((x) => x.message)); }
победил
AggregateError All promises were rejected [ 'e1', 'e2' ]
Подходит для запроса к нескольким зеркалам: берём ответ самого быстрого рабочего.
Сравнение
| Метод | Выполняется, когда | Отклоняется, когда |
|---|---|---|
all | все успешны | отклонён любой |
allSettled | все завершены | никогда |
race | первый завершился успехом | первый завершился ошибкой |
any | первый успешный | отклонены все |
Для пустого массива all и allSettled сразу возвращают [].
Promise.withResolvers
Современный метод (ES2024, есть в Node.js 22) возвращает промис вместе с функциями resolve и reject, чтобы управлять им снаружи — без обёртки new Promise:
const { promise, resolve } = Promise.withResolvers();
setTimeout(() => resolve("снаружи"), 10);
console.log(await promise); // снаружи
Сделайте три функции-«сервера» через delay с разным временем ответа и одну, которая падает. Выведите результат каждого комбинатора на этом наборе. Затем реализуйте withTimeout(promise, ms) на основе Promise.race: если промис не успел, функция должна отклониться с Error("Таймаут").
Оглавление курса
Модуль 1Старт10
- 1Что такое JavaScript и где он работает
- 2Инструменты: редактор и консоль браузера
- 3Первый скрипт: script, console.log и Node.js
- 4Переменные: let, const и var
- 5Типы данных
- 6Числа и объект Math
- 7Строки и шаблонные литералы
- 8Комментарии, стиль кода и точка с запятой
- 9Браузер и Node.js: чем отличаются среды
- 10История языка и стандарт ECMAScript
Модуль 2Операторы и управление потоком10
Модуль 3Функции10
Модуль 4Объекты и массивы10
Модуль 5Строки, числа, даты и данные10
Модуль 6DOM и события10
Модуль 7Браузерные API10
Модуль 8Прототипы и классы10
Модуль 9Асинхронность10
Модуль 10Модули и инструменты10
Модуль 11Продвинутые возможности10
Модуль 12Ошибки, тесты и безопасность10
Модуль 13Node.js10
Модуль 14Экосистема и фреймворки10
- 131TypeScript: типы в повседневной работе
- 132React: обзор
- 133Vue и Svelte: обзор
- 134Управление состоянием: обзор
- 135Мета-фреймворки: Next.js, Nuxt, SvelteKit
- 136Современные инструменты сборки
- 137Сквозные тесты: Playwright
- 138Паттерны проектирования в JavaScript
- 139Архитектура больших приложений
- 140Безопасность зависимостей
Модуль 15Профи10
- 141Движок V8 и JIT-компиляция
- 142Память и сборка мусора
- 143Event Loop глубже: микрозадачи и макрозадачи
- 144Производительность и Web Vitals
- 145Вопросы на собеседовании по JavaScript
- 146Алгоритмы и структуры данных на JavaScript
- 147Код-ревью
- 148Вклад в open source
- 149Дипломный проект: разработка
- 150Дипломный проект: защита и итоги
