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