JavaScript метод Promise.prototype.finally()
Определение и применение
JavaScript метод .finally() объекта
Promise
добавляет обработчик, который будет вызван вне зависимости от того с каким результатом объект
Promise
был выполнен (rejected - выполнение отклонено, или fulfilled - успешное выполнение).
Метод .finally() позволяет избежать дублирования кода в обработчиках, вызываемых когда объект
Promise имеет состояние fulfilled (успешное выполнение), или
rejected (выполнение отклонено), что обеспечивает возможность выполнить определенный код, когда обещание
было обработано, независимо от его состояния.
Обращаю Ваше внимание, что обработчик, переданный в .finally(), вызывается без аргументов, это связано с
тем, что не существует способа определить, будет обещание выполнено успешно, или с ошибкой. Этот метод рекомендуется
использовать в том случае, когда не важна причина ошибки, или результат успешного выполнения и, следовательно, нет
необходимости ее/его передавать.
В чем заключается отличие метода .finally() от
then()
Вы можете увидеть в примере внизу страницы.
Метод возвращает новое обещание. Обработчики вызываются асинхронно через очередь микрозадач, даже если результат уже известен.
Успешный возврат обычного значения из обработчика сохраняет исходный результат. Если обработчик возвращает обещание, цепочка ждёт его. Исключение или отклонение возвращённого обещания заменяет исходный результат новой причиной отклонения.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2018 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
finally | 63 | 18 | 58 | 50 | 11.1 | 63 | 58 | 46 | 11.3 | 8.0 | 63 | 11.3 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
p.finally(onFinally);
Спецификация
ECMAScript: Promise.prototype.finally()
Значения параметров
| Параметр | Описание |
|---|---|
onFinally |
Функция, которая будет вызвана, когда обещание имеет состояние settled (решенный) - обещание выполнено, или отклонено. |
Примеры, попробуйте сами
Базовое использование метода finally()
В примере «Обработчик обоих исходов» показан результат вызова метода.
Обработчик обоих исходов
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
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.reject(new Error('Отклонено')) // обещание отклонено с заданным значением
promise
.finally(() => console.log('Обещание успешно выполнено, или отклонено')) // добавляем обработчик, который будет вызван, когда обещание имеет состояние settled (решенный)
.then(
(val) => console.log(val),
(err) => console.log(err.message),
) // добавляем обработчики для успешного выполнения и для случая, когда выполнение отклонено
.finally(() => console.log('Обещание успешно выполнено, или отклонено')) // добавляем обработчик, который будет вызван, когда обещание имеет состояние settled (решенный)
// Обещание успешно выполнено, или отклонено
// Успешно
// Обещание успешно выполнено, или отклонено
promise2
.finally(() => console.log('Обещание успешно выполнено, или отклонено')) // добавляем обработчик, который будет вызван, когда обещание имеет состояние settled (решенный)
.then(
(val) => console.log(val),
(err) => console.log(err.message),
) // добавляем обработчики для успешного выполнения и для случая, когда выполнение отклонено
.finally(() => console.log('Обещание успешно выполнено, или отклонено')) // добавляем обработчик, который будет вызван, когда обещание имеет состояние settled (решенный)
// Обещание успешно выполнено, или отклонено
// Отклонено
// Обещание успешно выполнено, или отклонено
В этом примере мы инициализировали две переменные, которые содержат объект
Promise, который был успешно выполнен с заданным значением в первом случае, и отклонен во втором с указанием
причины в качестве значения.
С помощью метода .finally() мы установили по два обработчика, которые должны сработать, когда
обещание успешно выполнено, или отклонено. Кроме того, с помощью метода
then()
мы установили обработчики для успешного выполнения и для случая, когда выполнение отклонено.
Для первого объекта
Promise
будет вызван обработчик для успешного выполнения, и выведет в консоль полученное значение, а для
второго объекта
Promise
сработает обработчик метода
then(), предназначенный для того случая, когда выполнение было отклонено, в результате чего мы выводим в консоль текст
ошибки.
Обратите внимание на то, что методы .finally() срабатывают в обоих случаях, независимо от того, какое
состояние имеет объект
Promise
(fulfilled - успешное выполнение, или rejected - выполнение отклонено).
Отличие метода then() от finally()
В примере «Сохранение результата в finally» показан результат вызова метода.
Сохранение результата в finally
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Сохранение результата в finally</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
Promise.resolve(1)
.then(() => {})
.then((value) => console.log('then:', value))
Promise.resolve(1)
.finally(() => {})
.then((value) => console.log('finally:', value))
Promise.reject(1)
.then(null, () => {})
.then((value) => console.log('Обработано:', value))
Promise.reject(1)
.finally(() => {})
.catch((reason) => console.log('Отклонение сохранено:', reason))
Обратите внимание на основное отличие методов .finally() от
then(), метод .finally() передает полученное значение дальше без необходимости его явно возвращать, в отличии
от метода
then(), у которого обработчик без return даёт значение undefined.
Отклонение обещания внутри finally()
В примере «Новая ошибка из finally» показан результат вызова метода.
Новая ошибка из finally
Измените значение или результат обработчика и сравните порядок сообщений после запуска.
index.html
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Новая ошибка из finally</title>
</head>
<body>
<p>Результат выполнения выводится в консоль.</p>
</body>
</html>
main.js
const promise = Promise.resolve('Успешно') // обещание успешно выполнено с заданным значением
const promise2 = Promise.resolve('Успешно') // обещание успешно выполнено с заданным значением
promise
.finally(() => {
throw new Error('Отклонено')
})
.catch((err) => console.log(err.message))
// Отклонено
promise2
.finally(
() =>
new Promise(function (resolve, reject) {
reject(new Error('Отклонено'))
}),
)
.catch((err) => console.log(err.message))
// Отклонено
В этом примере мы инициализировали две переменные, которые содержат объект
Promise, который был успешно выполнен с заданным значением.
С помощью метода .finally() мы установили обработчики, которые должны сработать, когда обещание успешно
выполнено, или отклонено. Внутри метода .finally() мы в первом случае генерируем исключение с
указанным значением ошибки, а во втором случае возвращаем новое отклоненное обещание.
Генерация исключения, или возврат отклоненного обещания внутри вызова метода .finally() позволяет
отклонить новое обещание с указанной причиной отклонения.
С помощью метода
catch()
мы добавляем обработчики, которые будут вызваны при изменении состояния объекта Promise на
rejected (выполнение отклонено), и выводим в консоль текст ошибки.