JavaScript метод Promise.resolve()
Определение и применение
Promise.resolve(value) возвращает обещание, принимающее результат value. Обычное значение
даёт успешное выполнение; обещание или thenable может привести к выполнению, отклонению или ожиданию. Если
value — обещание с тем же конструктором, возвращается оно само.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
resolve | 32 | 12 | 29 | 19 | 8 | 32 | 29 | 19 | 8 | 2.0 | 4.4.3 | 8 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
Promise.resolve(value);
Спецификация
Значения параметров
| Параметр | Описание |
|---|---|
value |
Необязательное значение, по умолчанию undefined. В качестве аргумента может содержать объект
Promise, или thenable объект подобный обещанию. Под thenable объектом стоит понимать любой
объект (или функция), обладающий методом then(). Если значение распознается как обещание, или
объект thenable, то его состояние просто заимствуется.
|
Примеры, попробуйте сами
Простое значение в качестве аргумента
В примере «Успешное значение и массив» показан результат вызова метода.
Успешное значение и массив
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Успешное значение и массив</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const promise = Promise.resolve('Успешно') // Строковое значение в качестве аргумента
const promise2 = Promise.resolve(['thats', 'ok']) // Массив в качестве аргумента
promise.then(
function (value) {
// Если успешно выполнен (fulfilled)
console.log(value)
},
function (reason) {
// Если завершился ошибкой (rejected)
console.log(reason)
},
)
// Успешно
// использование стрелочной функции и метода forEach
promise2.then(
(val) => val.forEach((elem) => console.log(elem)), // обработчик для успешного выполнения
(reason) => console.log(reason),
) // обработчик при отклоненном выполнении
// thats
// ok
В этом примере мы инициализировали две переменные, которые содержат объект
Promise, который был успешно выполнен с заданным значением. В первом случае это строковое значение, а во втором массив
строковых значений.
Кроме того, с использованием метода
then()
добавили обработчики, вызываемые когда объект
Promise
имеет состояние fulfilled (успешное выполнение), или rejected (выполнение отклонено). В
нашем случае всегда будет срабатывать обработчик для успешного выполнения. Обратите внимание, что мы используем метод
forEach()
объекта
Array
для возможности вывести все значения из массива.
Объект Promise в качестве аргумента
В примере «Принятие результата другого обещания» показан результат вызова метода.
Принятие результата другого обещания
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Принятие результата другого обещания</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
var promise = Promise.resolve('Ok') // изменяем состояние объекта на fulfilled (успешное выполнение)
var promise2 = Promise.resolve(promise)
promise2.then((val) => console.log(val)) // обработчик для успешного выполнения
// Ok
var promise = Promise.reject(new Error('115')) // изменяем состояние объекта на rejected (выполнение отклонено)
var promise2 = Promise.resolve(promise)
promise2.then(
(val) => console.log(val), // обработчик для успешного выполнения
(err) => console.log(err.message),
) // обработчик при отклоненном выполнении
// 115
В этом примере в качестве аргумента метода .resolve() мы использовали другой объект
Promise, который автоматически заставляет второе обещание ждать результата его выполнения, заимствуя при этом его
состояние.
Thenable объект в качестве аргумента
В примере «Принятие thenable» показан результат вызова метода.
Принятие thenable
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Принятие thenable</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
// передаем в аргументе thenable объект подобный обещанию
const promise = Promise.resolve({
then: (onFulfill, onReject) => onFulfill('Ok!'),
})
promise.then(
(val) => console.log(val), // обработчик для успешного выполнения
(err) => console.log(err),
) // обработчик при отклоненном выполнении
// Ok!
В этом примере мы в качестве аргумента метода .resolve() передаем thenable объект подобный
обещанию. С использованием метода
then()
добавили обработчики, вызываемые когда объект
Promise
имеет состояние fulfilled (успешное выполнение), или rejected (выполнение отклонено). В
нашем случае будет срабатывать обработчик для успешного выполнения.
В примере «Исключение внутри thenable» показан результат вызова метода.
Исключение внутри thenable
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Исключение внутри thenable</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const thenable = {
then: function (resolve) {
throw new TypeError('Error') // генерируем исключение
resolve('Resolve') // метод не будет вызван
},
}
const promise = Promise.resolve(thenable).then(
(val) => console.log(val), // обработчик для успешного выполнения
(err) => console.log(err.message),
) // обработчик при отклоненном выполнении
// Error
В этом примере мы создаем переменную, содержащую thenable объект подобный обещанию. Метод объекта генерирует
исключение и при этом метод .resolve(), который содержит этот метод никогда не будет вызван, так как до
этого было сгенерировано исключение. Если бы исключение было сгенерировано после вызова resolve(), обещание уже считалось бы выполненным и исключение было бы проигнорировано.
Кроме того, мы с помощью метода
then()
добавили обработчики, вызываемые когда объект
Promise
имеет состояние fulfilled (успешное выполнение), или rejected (выполнение отклонено). В
нашем случае будет срабатывать обработчик при отклоненном выполнении.