JavaScript метод Promise.all()

Определение и применение

Promise.all(iterable) возвращает новое обещание. Оно успешно выполняется с массивом результатов, когда выполнены все входные обещания и thenable, либо отклоняется с причиной первого отклонения. Обычные значения также входят в результат. Пустой источник даёт уже выполненное обещание с [].

Этот метод может быть полезен для сбора результатов выполнения нескольких обещаний.

Метод возвращает новое обещание. Обработчики вызываются асинхронно через очередь микрозадач, даже если результат уже известен.

Порядок элементов результата соответствует порядку входного итерируемого объекта, а не времени завершения. Непустой набор, даже из обычных значений, завершается асинхронно. Promise.all([]) сразу выполнен с [], но его обработчики всё равно асинхронны. Отклонение результата не отменяет остальные операции.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Promise.all
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
all✓32✓12✓29✓19✓8✓32✓29✓19✓8✓2.0✓4.4.3✓8

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
Promise.all(iterable);

Спецификация

ECMAScript: Promise.all()

Значения параметров

Promise: справочные сведения
Параметр Описание
iterable Итерируемый объект (например, массив). Метод будет ожидать успешное выполнение всех переданных в массиве обещаний, или когда один из переданных объектов изменил своё состояние на rejected (выполнение отклонено). Если переданный объект пуст, то возвращенное обещание будет сразу переведено в состояние fulfilled (успешное выполнение). Если объект содержит одно, или несколько значений, которые не являются обещаниями, то метод разрешится с этими значениями.

Примеры, попробуйте сами

Базовое использование метода

В примере «Порядок результатов и время завершения» показан результат вызова метода.

Порядок результатов и время завершения

Измените значение или результат обработчика и сравните порядок сообщений после запуска.

index.html
HTML
<p>Результат выполнения выводится в консоль под примером.</p>
main.js
JavaScript
const promise = new Promise(function (resolve, reject) {
    setTimeout(resolve, 200, 'promise1') // изменяем состояние объекта на fulfilled (успешное выполнение) через 200 мс
})

const promise2 = new Promise(function (resolve, reject) {
    setTimeout(resolve, 100, 'promise2') // изменяем состояние объекта на fulfilled (успешное выполнение) через 100 мс
})

const promise3 = new Promise(function (resolve, reject) {
    setTimeout(resolve, 50, 'promise3') // изменяем состояние объекта на fulfilled (успешное выполнение) через 50 мс
})

Promise.all([promise, promise2, promise3]) // ожидаем выполнение всех переданных в массиве обещаний / или отклонения какого-то обещания
    .then((val) => console.log(val)) // обработчик для успешного выполнения

// ["promise1", "promise2", "promise3"]
style.css
CSS
body {
  margin: 16px;
  font:
    16px/1.5 system-ui,
    sans-serif;
  overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
  max-width: 100%;
}

В этом примере мы инициализировали три переменные, которые содержат объект Promise, который изменяет состояние объекта на fulfilled (успешное выполнение) через 200 мс в первом случае, через 100 мс во втором и через 50 мс в третьем.

С использованием метода .all() объекта Promise мы принимаем массив, который содержит ссылку на три обещания, результат выполнения этого метода зависит от того с каким результатом завершится выполнение обещаний, в нашем случае он возвращает объект Promise, который имеет состояние fulfilled (успешное выполнение), так как все переданные объекты Promise в аргументе имеют состояние fulfilled (успешное выполнение).

С использованием метода then() мы добавили обработчик, вызываемый когда объект Promise имеет состояние fulfilled (успешное выполнение), и выводим в консоль полученное значение (массив полученных значений из всех обещаний).

Далее мы с Вами рассмотрим пример в котором увидим, что произойдет, если одно из обещаний будет отклонено:

В примере «Отклонение одного из обещаний» показан результат вызова метода.

Отклонение одного из обещаний

Измените значение или результат обработчика и сравните порядок сообщений после запуска.

index.html
HTML
<p>Результат выполнения выводится в консоль под примером.</p>
main.js
JavaScript
const promise = new Promise(function (resolve, reject) {
    setTimeout(resolve, 200, 'promise1') // изменяем состояние объекта на fulfilled (успешное выполнение) через 200 мс
})

const promise2 = new Promise(function (resolve, reject) {
    setTimeout(reject, 100, new Error('Обещание отклонено')) // изменяем состояние объекта на rejected (выполнение отклонено) через 100 мс
})

const promise3 = new Promise(function (resolve, reject) {
    setTimeout(resolve, 50, 'promise3') // изменяем состояние объекта на fulfilled (успешное выполнение) через 50 мс
})

Promise.all([promise, promise2, promise3]) // ожидаем выполнение всех переданных в массиве обещаний / или отклонения какого-то обещания
    .then(
        (val) => console.log(val), // обработчик для успешного выполнения
        (err) => console.log(err.message),
    ) // обработчик для случая, когда выполнение отклонено

// Обещание отклонено
style.css
CSS
body {
  margin: 16px;
  font:
    16px/1.5 system-ui,
    sans-serif;
  overflow-wrap: anywhere;
}
img,
input,
select,
textarea,
button {
  max-width: 100%;
}

По аналогии с предыдущим примером мы инициализировали три переменные, которые содержат объект Promise, который изменяет состояние объекта на fulfilled (успешное выполнение) через 200 мс в первой и через 50 мс в третьей переменной. Обратите внимание, что с помощью метода reject() мы изменяем значение объекта Promise на rejected (выполнение отклонено) через 100 мс во второй переменной.

С использованием метода .all() объекта Promise мы принимаем массив, который содержит ссылку на три обещания, результат выполнения этого метода зависит от того с каким результатом завершится выполнение обещаний, в нашем случае он возвращает объект Promise, который имеет состояние rejected (выполнение отклонено), это связано с тем, что один из переданных объектов изменил своё состояние на rejected (выполнение отклонено).

С использованием метода then() мы добавили обработчики, вызываемые когда объект Promise имеет состояние fulfilled (успешное выполнение), или rejected (выполнение отклонено). В нашем случае срабатывает обработчик для отклоненного выполнения, и выводит информацию об ошибке в консоль.

Нюансы использования метода

В примере «Обычные значения и пустой набор» показан результат вызова метода.

Обычные значения и пустой набор

Измените значение или результат обработчика и сравните порядок сообщений после запуска.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Обычные значения и пустой набор</title>
  </head>
  <body>
    <p>Результат выполнения выводится в консоль.</p>
  </body>
</html>
main.js
JavaScript
Promise.all(['Тест', 'Тест2']).then((val) => console.log(val)) // обработчик для успешного выполнения

// ["Тест", "Тест2"]

Promise.all([Promise.resolve(1), Promise.resolve(2)]).then((val) => console.log(val)) // обработчик для успешного выполнения

// [1, 2]

Promise.all([]).then((val) => console.log(val)) // обработчик для успешного выполнения

// []

В этом примере мы рассмотрели основные нюансы использования метода .all(), например, если объект содержит одно, или несколько значений, которые не являются обещаниями, то метод разрешится с этими значениями. Если переданный объект пуст, то возвращенное обещание будет сразу переведено в состояние fulfilled (успешное выполнение).