Promise.reject()

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

Especificação Situação Comentário
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Promise.reject' in that specification.
Padrão Definição inicial em um padrão ECMA.
ECMAScript (ECMA-262)
The definition of 'Promise.reject' in that specification.
Padrão em tempo real  

Compatibilidade com browsers

BCD tables only load in the browser

 

Ver também