A correspondência entre o arquivo publicado e o original
Um source map é um arquivo de mapeamento que relaciona posições do código transformado às posições do código original. Durante o build, uma ferramenta pode juntar arquivos e reduzir o tamanho do JavaScript. O source map permite localizar no original a instrução correspondente a uma posição dessa saída.
Com essa correspondência, o Chrome DevTools pode mostrar o arquivo que você escreveu e permitir pontos de parada na representação original. O navegador continua executando o JavaScript publicado, mesmo quando a tela de depuração apresenta outro nome de arquivo e outra numeração de linhas.
Da linha minificada ao trecho que você escreveu
Neste exemplo didático, o site carrega app.min.js, que termina com a indicação do arquivo de mapeamento:
//# sourceMappingURL=app.min.js.mapO comentário informa ao DevTools onde procurar o source map. Quando o recurso está habilitado e o arquivo pode ser carregado, a ferramenta usa suas correspondências para apresentar as posições originais. Uma falha localizada na linha 1 do JavaScript minificado pode, por exemplo, aparecer na função de validação de um arquivo do projeto.
Essa localização permite abrir o trecho original e acompanhar a execução. Ela ainda precisa ser interpretada junto com os valores recebidos pela função, pois localizar uma instrução não explica por que ela falhou.
O mapeamento precisa acompanhar o build
Um source map só descreve a transformação que o gerou. Usar o arquivo de outra versão pode indicar uma linha incorreta, mesmo que o JavaScript publicado conserve o mesmo nome.
Quando a correspondência parecer errada, confira qual JavaScript o navegador carregou e se o DevTools conseguiu obter o source map associado. Compare esses arquivos com o build investigado. Sem o mapeamento, a ferramenta apresenta a versão transformada, que pode ter nomes abreviados e várias instruções na mesma linha.
Dúvidas frequentes
Perguntas frequentes sobre source map
- O navegador executa o source map?
- O navegador executa o JavaScript publicado. O DevTools consulta o source map para apresentar o original e relacionar as posições usadas durante a depuração.
- Um source map antigo pode localizar a linha errada?
- Sim. Ele precisa corresponder à transformação que produziu o arquivo executado. Misturar versões pode indicar posições incorretas.
- O source map corrige o erro?
- O arquivo fornece a correspondência entre posições do código. Você ainda precisa investigar a causa, corrigir o original e gerar outra versão da aplicação.
Para continuar
Recursos relacionados
Documentação
Chrome DevTools: source maps
Mostra como habilitar o mapeamento no Chrome DevTools e acompanhar a execução pelos arquivos originais.
Abrir recursoSite de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão ao vivo para investigar o código da aplicação, com você operando o editor e o terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A investigação de erros precisa localizar o trecho original correspondente ao código executado pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.