Promise.reject
Создаёт промис, который сразу отклонён с заданной ошибкой.
Доступно с: ES2015
Синтаксис
Promise.reject(reason)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| reason | any | Причина отказа — обычно объект Error. |
Возвращаемое значение
PromiseУже отклонённый промис.
Примеры
Отклонённый промис и его обработка:
try {
await Promise.reject(new Error('Not found'));
} catch (error) {
console.log(error.message);
}Результат:
Not foundПримечания
В async-функции вместо return Promise.reject(error) проще написать throw error — результат тот же.
См. также
- Promise.resolve — Создаёт промис, который сразу выполнен с заданным значением.
- Promise.prototype.catch — Обрабатывает ошибку промиса.
- Error — Базовый класс ошибок: создаётся и выбрасывается через throw.
В учебнике
- Промисы — Промисы в JavaScript: состояния промиса, then, catch, finally, создание промиса через new Promise и цепочки.