Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Promise.prototype.catch — tratamento de rejeições

O método catch() associa um tratador de rejeições a uma promise. Permite recuperar, devolvendo um valor de sucesso, ou propagar uma falha e, com o método then padrão, devolve uma nova promise.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

promise.catch(onRejected)

Promise.prototype.catch chama this.then(undefined, onRejected). Com o método then padrão, devolve uma nova promise sem alterar o estado da promise original. O tratador onRejected recebe o motivo da rejeição, que não tem de ser um objeto Error, e é executado de forma assíncrona, mesmo que a promise já tenha sido rejeitada.

Devolver um valor normal do tratador cumpre a nova promise com esse valor; omitir return produz undefined. Devolver uma promise ou um objeto com um método then invocável faz com que a nova promise adote o respetivo resultado final. Lançar um erro rejeita a nova promise. Para propagar uma falha, utiliza throw em vez de te limitares a apresentá-la.

Se a promise for cumprida, o tratador é ignorado e o valor é passado adiante. Se onRejected não for uma função, a rejeição também é passada adiante. Um catch colocado depois de then também trata erros lançados nesse passo anterior, mas não erros em passos posteriores nem em operações assíncronas independentes que não tenham sido devolvidas.

Exemplos

Promise.resolve(10)
  .then(() => {
    throw new Error("failed");
  })
  .catch((error) => {
    console.log(error.message);
    return 42;
  })
  .then((value) => {
    console.log(value);
  });
console.log("sync");

Resultado

sync
failed
42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes