JavaScript метод Promise.all()
Определение и применение
Promise.all(iterable) возвращает новое обещание. Оно успешно выполняется с массивом результатов, когда
выполнены все входные обещания и thenable, либо отклоняется с причиной первого отклонения. Обычные значения также
входят в результат. Пустой источник даёт уже выполненное обещание с [].
Этот метод может быть полезен для сбора результатов выполнения нескольких обещаний.
Метод возвращает новое обещание. Обработчики вызываются асинхронно через очередь микрозадач, даже если результат уже известен.
Порядок элементов результата соответствует порядку входного итерируемого объекта, а не времени завершения. Непустой
набор, даже из обычных значений, завершается асинхронно. Promise.all([]) сразу выполнен с
[], но его обработчики всё равно асинхронны. Отклонение результата не отменяет остальные операции.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
all | 32 | 12 | 29 | 19 | 8 | 32 | 29 | 19 | 8 | 2.0 | 4.4.3 | 8 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
Promise.all(iterable);
Спецификация
Значения параметров
| Параметр | Описание |
|---|---|
iterable |
Итерируемый объект (например, массив). Метод будет ожидать успешное выполнение всех переданных в массиве
обещаний, или когда один из переданных объектов изменил своё состояние на rejected (выполнение
отклонено). Если переданный объект пуст, то возвращенное обещание будет сразу переведено в состояние
fulfilled (успешное выполнение). Если объект содержит одно, или несколько значений, которые не
являются обещаниями, то метод разрешится с этими значениями.
|
Примеры, попробуйте сами
Базовое использование метода
В примере «Порядок результатов и время завершения» показан результат вызова метода.
Порядок результатов и время завершения
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<p>Результат выполнения выводится в консоль под примером.</p>
main.js
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
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
<p>Результат выполнения выводится в консоль под примером.</p>
main.js
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
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 lang="ru">
<head>
<meta charset="UTF-8" />
<title>Обычные значения и пустой набор</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
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 (успешное выполнение).