Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Vibe Coding: Do Zero ao MVP

    O que é stack trace?

    Um stack trace registra chamadas de função capturadas durante a execução. No Node.js, o error.stack permite localizar a criação de um objeto Error.

    Também chamado de: rastreamento de pilha, rastro de pilha

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    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

    O registro da pilha de chamadas

    Um stack trace é um registro das chamadas de função capturadas em determinado ponto da execução. No Node.js, a propriedade error.stack descreve o local de criação de um objeto Error, com a mensagem e as chamadas disponíveis naquele momento.

    Cada chamada aparece em um quadro, também chamado de frame, que pode identificar a função e sua localização no arquivo. Você usa esse registro para chegar ao código relacionado à falha, mas precisa comparar as posições com a versão que estava em execução.

    Ler a mensagem e seguir as chamadas

    O trecho didático abaixo ilustra parte de um rastreamento no Node.js. Ele representa uma função exportar que chamou consultarAssinatura, onde o erro foi criado:

    Error: Assinatura não encontrada
    at consultarAssinatura (/app/assinaturas.js:12:9)
    at exportar (/app/exportacao.js:28:3)

    A primeira linha informa o tipo e a mensagem do erro. No primeiro quadro, 12:9 indica a linha 12 e a coluna 9 de assinaturas.js. O quadro seguinte mostra a chamada feita por exportar, na linha 28 e coluna 3 de exportacao.js.

    Você pode examinar o argumento enviado por exportar e como a consulta responde à ausência da assinatura. O rastreamento não contém, por si só, o valor desse argumento nem comprova que a função de consulta está incorreta. Uma entrada inválida pode ter sido produzida em outra parte da aplicação.

    O alcance da captura no Node.js

    O local de criação do erro pode diferir do local onde ele é lançado. Criar um objeto Error, guardá-lo e lançá-lo depois não transforma seu rastreamento em um registro completo das chamadas posteriores.

    O número de quadros depende das chamadas disponíveis e de Error.stackTraceLimit. O formato também varia conforme o ambiente de execução. Um stack trace não reconstrói todo o processamento de uma requisição entre tarefas assíncronas e outros processos.

    Quando o código tiver sido minificado, um source map correspondente ao build pode ajudar a localizar o original. Para investigar a causa, compare o trecho indicado com os registros da requisição e com uma entrada que reproduza a falha.

    Dúvidas frequentes

    Perguntas frequentes sobre stack trace

    O stack trace mostra toda a execução?
    Não. Ele registra os quadros disponíveis conforme o runtime e seus limites. Não substitui um histórico completo do processamento.
    A primeira linha indica necessariamente a causa?
    A primeira linha apresenta o tipo e a mensagem do erro. Os quadros seguintes localizam as chamadas capturadas. A causa ainda precisa ser investigada no código e na entrada recebida.
    Os números de linha podem mudar entre versões?
    Sim. A localização precisa ser comparada com a versão executada. Transformações do código também podem exigir um source map correspondente.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    O registro das chamadas permite localizar o trecho de código que precisa ser investigado após uma falha.

    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