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

CKTIS / JavaScript

try — tratamento de exceções

A instrução try define um bloco cujas exceções podem ser tratadas por catch. Um finally opcional executa código de finalização mesmo durante um return ou a propagação de uma exceção. É necessário catch, finally ou ambos.

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 { statements } catch (error) { handler }
try { statements } finally { cleanup }
try { statements } catch (error) { handler } finally { cleanup }
// Optional catch binding:
try { statements } catch { handler }

try é uma palavra reservada que inicia uma instrução de tratamento de exceções. O bloco tem de ser seguido de catch, finally ou ambos, por esta ordem. As chavetas são obrigatórias; try { ... } por si só é inválido.

Se a execução do bloco try lançar uma exceção, as restantes instruções desse bloco são ignoradas. catch (error) associa o valor lançado ao parâmetro local error; esse valor não tem de ser um objeto Error. Se o parâmetro não for necessário, pode usar-se catch { ... }. Se não ocorrer nenhuma exceção, o bloco catch é ignorado. Uma nova exceção proveniente de catch não é capturada pelo mesmo catch.

finally é executado antes de esta instrução terminar, incluindo quando se sai através de return ou de uma exceção. Se finally terminar normalmente, mantém-se o retorno ou a exceção pendente. Isto também acontece se uma exceção lançada por throw for capturada dentro de finally e o bloco terminar normalmente a seguir. Já um return que faz sair de finally ou uma exceção que se propaga para fora do bloco substitui o retorno ou a exceção pendente. Evite essa substituição no código de limpeza.

No exemplo, throw impede o registo de "unreachable", catch regista a mensagem e finally acrescenta o último elemento.

Exemplos

const events = [];

try {
  events.push("try");
  throw new Error("stop");
  events.push("unreachable");
} catch (error) {
  events.push(error.message);
} finally {
  events.push("finally");
}

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

Resultado

try | stop | finally

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