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

CKTIS / JavaScript

Tratamento de erros e exceções

O tratamento de erros permite reagir a exceções sem as misturar com o resultado normal de uma função. Aprende throw, try, catch e finally, e distingue exceções síncronas de rejeições de 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

throw new Error(message);
try {
  operation();
} catch (error) {
  handle(error);
} finally {
  cleanup();
}

Uma exceção interrompe o percurso de execução atual. throw pode lançar qualquer valor, mas utiliza objetos Error ou os seus subtipos: têm as propriedades name e message. TypeError descreve um tipo inadequado ou uma operação inválida, enquanto RangeError descreve um valor fora do intervalo permitido. new Error(message) apenas cria um objeto, não lança uma exceção.

try envolve operações que podem lançar uma exceção; catch (error) recebe o valor lançado, incluindo quando vem de uma função chamada de forma síncrona. A execução não retoma na instrução interrompida. Trata apenas os erros a que consegues responder de forma útil; volta a lançar os restantes com throw error. Um erro de sintaxe que impeça a análise do mesmo script não pode ser capturado pelo catch desse script.

finally é executado quando o controlo sai de try ou catch, incluindo através de return ou de uma exceção. Usa-o para limpeza. Evita colocar aí return e throw, pois podem substituir um resultado ou uma exceção anteriores. Uma instrução try requer catch, finally ou ambos.

Um try síncrono não captura uma rejeição posterior de Promise apenas por a promessa ter sido criada dentro do seu bloco. Usa await num try dentro de uma função async, ou acrescenta .catch(handler). O exemplo utiliza mecanismos básicos de exceções disponíveis desde ECMAScript 3; Promise é de ECMAScript 2015 e async/await de ECMAScript 2017. Não requer Web APIs, além de console.log fornecido pelo ambiente; uma versão de Node.js, por si só, não comprova suporte nos navegadores.

Exemplos

function requirePositive(value) {
  if (!(value > 0)) {
    throw new RangeError("value must be positive");
  }
  return value;
}

try {
  console.log(requirePositive(-1));
} catch (error) {
  if (!(error instanceof RangeError)) {
    throw error;
  }
  console.log(error.name + ": " + error.message);
} finally {
  console.log("finished");
}

Resultado

RangeError: value must be positive
finished

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