Promise.reject()

Метод Promise.reject(reason) возвращает объект Promise, который был отклонён по указанной причине.

Синтаксис

Promise.reject(reason);

Параметры

reason: Причина по которой Promise был отклонён.

Возвращаемое значение

Отклонённый с указанной причиной Promise.

Описание

Promise.reject возвращает Promise который был отклонён. В целях отладки и выборочного отлова ошибок, удобно использовать в качестве причины объекты Error.

Примеры

Использование статического метода Promise.reject()

Promise.reject(new Error("провал")).then(function(success) {
  // не вызывается
}, function(error) {
  console.log(error); // печатает "провал" + Stacktrace
  throw error; // повторно выбрасываем ошибку, вызывая новый reject
});

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

Specification
ECMAScript Language Specification # sec-promise.reject

Совместимость с браузерами

BCD tables only load in the browser