Digite para filtrar os verbetes do Glossário.

    Git e qualidade · Vibe Coding: Do Zero ao MVP

    O que é exceção não tratada?

    Uma exceção não tratada se propaga pelas chamadas sem encontrar uma captura. No Node.js, o comportamento padrão mostra o erro e encerra o processo afetado.

    Também chamado de: uncaught exception, unhandled exception

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano