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 navegadores

BCD tables only load in the browser

Ver também