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
Documentação
Node.js: propriedade error.stack
Explica o local de criação do Error, o formato dos quadros e o limite de chamadas capturadas.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão ao vivo para seguir as chamadas de um erro no seu código, com você operando o editor e o terminal.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.