Promise.reject()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O método Promise.reject(motivo) retorna um objeto Promise que é rejeitada com um dado motivo.

Sintaxe

Promise.reject(motivo);

Parâmetros

motivo: Motivo pelo qual este Promise foi rejeitado.

Descrição

O método estático Promise.reject retorna uma Promise que é rejeitada. Para fins de debug e captura de erros seletiva, é útil que o motivo seja uma instanceof Error.

Exemplos

Usando o método estático Promise.reject()

Promise.reject("Testando reject estático").then(
  function (motivo) {
    // não executado
  },
  function (motivo) {
    console.log(motivo); // "Testando reject estático"
  },
);

Promise.reject(new Error("falha")).then(
  function (erro) {
    // não executado
  },
  function (erro) {
    console.log(erro); // Stacktrace
  },
);

Especificações

Specification
ECMAScript® 2026 Language Specification # sec-promise.reject