Pular para o conteúdo

Resolver source map

Source Map Resolver

Mapeia um stack trace minificado de volta aos arquivos e linhas originais usando um source map que você fornece.

Pega um stack trace de um bundle minificado e um arquivo `.map`, e diz de qual linha de qual código-fonte original cada frame veio. Tudo é decodificado na aba: nem o mapa nem o trace, que muitas vezes nomeia seus caminhos internos, vão a lugar nenhum.

🔒 Roda inteiramente no seu navegadorsourcemapdebugstacktracejavascript

Source map (.map)

Solte um arquivo .map

Lido nesta aba. Nada é enviado.

Stack trace minificado

Source Map v3, decodificado nesta aba: mapeamentos base64-VLQ, a busca pela maior coluna anterior do jeito que as devtools fazem, e os nomes originais restaurados da tabela names. O código-fonte original aparece só quando o mapa embute sourcesContent — um mapa sem isso sabe posições, não código. Linhas de quadro que não dá para ler passam sem mudança.

Como usar

  1. Consiga o mapa

    Ou o próprio arquivo `.map`, ou o URI `data:` de um comentário `sourceMappingURL` no fim do bundle. Os dois colam aqui.

  2. Cole o stack trace

    Direto de um relatório de erro: o texto inteiro, linha `Error:` incluída. Frames que não são analisados passam sem mudança em vez de sumir.

  3. Leia as posições originais

    Cada frame recebe seu arquivo-fonte, linha, coluna e — onde a tabela `names` do mapa tem — o nome original da função. Copie o trace remapeado inteiro com um botão.

Perguntas frequentes

Por que nenhuma linha de código é mostrada?

Porque o mapa não embute `sourcesContent`. Um mapa sem ele sabe onde as coisas estavam, não o que estava escrito ali; a estatística abaixo do mapa diz se o seu tem. Faça o build com `sourcemap: true` em vez de uma configuração só de caminhos se você quer o código.

Um frame diz “sem mapeamento nesta posição”.

A coluna desse frame cai fora de qualquer segmento de mapeamento. Normalmente significa que o mapa é de um build diferente do arquivo que lançou o erro: um deploy que publicou código novo com um mapa antigo, ou um CDN servindo um bundle em cache.

É seguro colar um source map de produção aqui?

Nada sai da aba: a decodificação VLQ e a consulta são feitas no seu navegador. Vale lembrar que um mapa com `sourcesContent` contém todo o seu código-fonte original, então onde você o cola importa em geral, mesmo que aqui não.

Qual versão de source map ele lê?

v3, a única que alguém emite. Mapas de índice — a forma com `sections` usada em bundles muito grandes — não são suportados; forneça o mapa da seção que cobre o seu frame em vez disso.

Pode receber de

Em seguida

Estas aceitam o que esta ferramenta produz, então o resultado pode ir direto.