Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Vibe Coding: Do Zero ao MVP

    O que é source map?

    Um source map relaciona posições do código transformado ao original. A ferramenta de depuração usa o arquivo para localizar trechos e pontos de parada.

    Também chamado de: sourcemap, arquivo de mapeamento de código

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    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

    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.map

    O 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

    Aplicaçã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
    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