Como a exceção se propaga
Uma exceção não tratada é uma falha lançada durante a execução que se propaga pelas chamadas de função sem encontrar uma captura aplicável. Em JavaScript, um bloco catch pode interceptar uma exceção lançada dentro do try correspondente, inclusive por uma função chamada ali.
Quando a exceção chega ao laço de eventos do Node.js sem captura, ocorre o evento uncaughtException. O comportamento padrão imprime o rastreamento das chamadas na saída de erros, chamada stderr, e encerra o processo com código 1.
Uma leitura de JSON interrompida
O exemplo didático abaixo tenta interpretar um texto incompleto como JSON. Você pode executá-lo isoladamente no Node.js, sem tratadores globais de exceção:
function lerConfiguracao(texto) { return JSON.parse(texto)}
lerConfiguracao('{')console.log('Configuração lida')A entrada '{' contém apenas a abertura de um objeto. O JSON.parse lança um SyntaxError, que sai de lerConfiguracao sem encontrar um catch. Nesse caso, a mensagem final não é impressa e o processo termina com o comportamento padrão descrito acima.
Para uma entrada que pode estar malformada, a captura deve permitir uma resposta definida, como informar que o arquivo precisa de correção. Instalar um tratador global altera o comportamento padrão, mas não restaura o estado que a aplicação tinha ao falhar. A documentação do Node.js reserva esse mecanismo para a limpeza síncrona necessária ao encerramento.
Dúvidas frequentes
Perguntas frequentes sobre exceção não tratada
- Qual é a diferença entre capturar e registrar uma exceção?
- A captura intercepta a exceção e permite executar um tratamento. O registro grava ou exibe informações sobre a falha. Um log pode fazer parte do tratamento, mas não restaura por si só o estado da aplicação.
- É seguro continuar a aplicação pelo evento uncaughtException?
- A documentação do Node.js orienta usar esse evento como último recurso para limpeza síncrona e encerramento. A aplicação pode estar em estado indefinido, por isso o evento não deve ser usado para retomar o trabalho normal.
- Uma rejeição de Promise é o mesmo evento?
- O Node.js distingue unhandledRejection de uncaughtException. Uma rejeição sem tratamento também pode ser elevada a uma exceção não capturada, conforme a configuração de --unhandled-rejections e os tratadores instalados.
Para continuar
Recursos relacionados
Documentação
Node.js: exceções que alcançam o laço de eventos
Referência do evento uncaughtException, do encerramento padrão e das restrições para usar um tratador global.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para você reproduzir uma exceção e investigar sua origem no código da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.