O estouro de pilha é a falha causada pelo crescimento da pilha de chamadas além do espaço disponível. Essa estrutura registra as funções cuja execução ainda não terminou e os pontos aos quais o programa deve retornar.
Uma chamada aninhada acrescenta um registro à pilha. Quando a função termina, seu registro é removido e a execução continua na chamada anterior. Uma recursão profunda mantém muitas chamadas pendentes ao mesmo tempo, o que pode esgotar esse espaço.
Uma função com retorno previsto
O exemplo didático abaixo retorna a profundidade recebida, mas percorre esse valor com chamadas recursivas. Ele aceita como entrada um inteiro não negativo.
function profundidade(n) { if (n === 0) return 0 return 1 + profundidade(n - 1)}
console.log(profundidade(3))A chamada profundidade(3) retorna 3, depois de chegar a profundidade(0) e concluir as somas pendentes. Cada chamada espera o retorno da seguinte. Um inteiro muito grande pode exigir chamadas demais para a pilha, mesmo com a condição n === 0 prevista no código.
Você pode examinar o rastreamento do erro para localizar a função repetida e conferir se a entrada se aproxima da condição de parada. O mesmo crescimento também pode envolver funções diferentes que chamam umas às outras.
Limites do ambiente de execução
A MDN documenta as mensagens de recursão excessiva e de tamanho máximo da pilha excedido no JavaScript. A mensagem e a profundidade suportada dependem do ambiente, por isso o exemplo não define um número universal de chamadas.
O esgotamento da pilha se refere ao espaço reservado para essa estrutura. O erro não demonstra que toda a memória da máquina acabou. Na investigação, confira tanto a progressão até o retorno quanto a quantidade de chamadas que permanecem pendentes.
Dúvidas frequentes
Perguntas frequentes sobre estouro de pilha
- Toda recursão provoca estouro de pilha?
- A falha depende da profundidade das chamadas que permanecem na pilha. Uma recursão que retorna dentro do espaço disponível pode terminar normalmente.
- Uma condição de parada evita qualquer estouro?
- A condição precisa ser alcançada dentro da profundidade suportada. Uma função pode ter um retorno previsto e ainda exceder o espaço da pilha até chegar a ele.
- Existe um número fixo de chamadas que causa o erro?
- O limite depende do ambiente de execução e do espaço utilizado por cada chamada. Um valor observado em um navegador não deve ser aplicado a todos os runtimes.
Para continuar
Recursos relacionados
Documentação
MDN: funcionamento da pilha de chamadas
Explica como a pilha acompanha chamadas de funções, retornos e o esgotamento do espaço reservado para essa estrutura.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para investigar chamadas recursivas e comparar o comportamento do código com diferentes profundidades de entrada.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A revisão do código gerado por agentes inclui acompanhar chamadas recursivas e conferir seu comportamento com entradas profundas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.