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

CKTIS / JavaScript

catch — tratamento de exceções

A palavra-chave catch introduz um gestor para uma exceção lançada durante a execução de um bloco try. O seu parâmetro opcional disponibiliza o valor lançado. Depois de a exceção ser tratada, a execução pode continuar após a instrução try...catch.

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

try {
  // protected statements
} catch (error) {
  // handle the thrown value
}

try {
  // protected statements
} catch {
  // handle without binding the thrown value
}

catch é uma palavra-chave e uma palavra reservada sem exceções: não pode ser usada como nome de variável. Forma uma cláusula de uma instrução try, não uma instrução autónoma. Tanto o bloco try como o bloco catch exigem chavetas.

Quando a execução do bloco try termina com o lançamento de uma exceção, as instruções restantes desse bloco são ignoradas e o controlo passa para catch. Se não ocorrer nenhuma exceção, o bloco catch é ignorado. O parâmetro de catch (error) é local ao gestor e recebe o valor lançado, que não tem de ser um objeto Error. Um padrão de desestruturação pode substituir o identificador.

Se o valor lançado não for necessário, usa catch { ... }: omite tanto o parâmetro como os parênteses, em vez de escrever catch (). Não ignores erros sem uma decisão deliberada; um caso não tratado pode ser propagado com throw error. Uma exceção lançada dentro de catch não é novamente capturada pela mesma cláusula.

Se o bloco catch terminar normalmente, a execução só continua após a instrução completa se não houver um bloco finally ou se este também terminar normalmente. Se existir, o bloco finally é executado antes de se sair da instrução e pode ainda lançar uma exceção, sair da função com return ou alterar de outra forma o fluxo de controlo. No exemplo, throw impede a adição de "unreachable", e catch regista a mensagem de erro.

Exemplos

const events = [];

try {
  events.push("start");
  throw new Error("invalid value");
  events.push("unreachable");
} catch (error) {
  events.push(error.message);
}

events.push("done");
console.log(events.join(" | "));

Resultado

start | invalid value | done

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