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.