Depurar seu código original em vez de implantado com mapas de origem

Meggin Kearney
Meggin Kearney
Sofia Emelianova
Sofia Emelianova

Mantenha o código no lado do cliente legível e depurável mesmo depois de combiná-lo, minificar ou compilar. Use mapas de origem para mapear o código-fonte para o código compilado no painel Origens.

Começar a usar os pré-processadores

Os mapas de origem dos pré-processadores fazem com que as Ferramentas do desenvolvedor carreguem os arquivos originais e minificados.

O Chrome vai executar o código minimizado, mas o painel Sources vai mostrar o código que você criou. É possível definir pontos de interrupção e percorrer o código nos arquivos de origem, e todos os erros, registros e pontos de interrupção serão mapeados automaticamente.

Isso dá a aparência de depuração do código conforme você o escreveu, em vez de um código que é enviado pelo servidor de desenvolvimento e executado pelo navegador.

Para usar mapas de origem no painel Origens:

  • Use apenas os pré-processadores que podem produzir mapas de origem.
  • Verifique se o servidor da Web pode exibir mapas de origem.

Usar um pré-processador compatível

Os pré-processadores comuns usados em conjunto com mapas de origem incluem, entre outros:

Para uma lista mais extensa, consulte Mapas de origem: idiomas, ferramentas e outras informações.

Ativar mapas de origem nas Configurações

Em Configurações. Configurações > Preferências > Fontes, marque Caixa de seleção. Mapas de origem do JavaScript.

Verificar se os mapas de origem foram carregados

Consulte Recursos para desenvolvedores: visualizar e carregar mapas de origem manualmente.

Depurar com mapas de origem

Com os mapas de origem prontos e ativados, é possível fazer o seguinte:

  1. Abra as origens do seu site no painel Origens.
  2. Para se concentrar apenas no código que você criou, agrupe os arquivos criados e implantados na árvore de arquivos. Em seguida, abra a seção Criado. Authored e abra o arquivo de origem original no Editor.

    O arquivo original aberto na seção "Autorizado".

  3. Defina um ponto de interrupção como de costume. Por exemplo, um logpoint. Em seguida, execute o código.

    Um ponto de registro definido em um arquivo criado.

  4. O Editor coloca um link para o arquivo implantado na barra de status na parte de baixo. Da mesma forma, isso acontece com os arquivos CSS implantados.

    Um link para os arquivos CSS implantados na barra de status.

  5. Abra a gaveta do console. Neste exemplo, ao lado da mensagem do ponto de registro, o console mostra um link para o arquivo original, não o implantado.

    A mensagem do console com um link para o arquivo original.

  6. Mude o tipo de ponto de interrupção para um normal e execute o código novamente. A execução é pausada.

    A execução foi pausada em um ponto de interrupção regular.

    O painel Pilha de chamadas mostra o nome do arquivo original, não o implantado.

  7. Na barra de status na parte de baixo do Editor, clique no link para o arquivo implantado. O painel Origens leva você ao arquivo correspondente.

O arquivo implantado com o comentário "sourceMappingURL".

Quando você abre qualquer arquivo implantado, o DevTools notifica se ele encontrou o comentário //# sourceMappingURL e o arquivo original associado.

O Editor imprimiu o arquivo implantado de forma bonita. Na verdade, ele contém todo o código em uma única linha, exceto o comentário //# sourceMappingURL.

Chamar eval() com #sourceURL

O #sourceURL simplifica a depuração ao lidar com chamadas eval(). Esse auxiliar é muito parecido com a propriedade //# sourceMappingURL. Para mais informações, consulte a especificação do Source Map V3.

O comentário //# sourceURL=/path/to/source.file instrui o navegador a procurar o arquivo de origem quando você usa eval(). Isso ajuda a nomear suas avaliações e scripts e estilos inline.

Teste nesta página de demonstração:

  1. Abra o DevTools e acesse o painel Origens.
  2. Na página, insira um nome de arquivo arbitrário no campo de entrada Nomeie seu código.
  3. Clique no botão Compile. Um alerta aparece com a soma avaliada da origem do CoffeeScript.
  4. Na árvore de arquivos do painel Página, abra um novo arquivo com o nome personalizado que você inseriu. Ele contém o código JavaScript compilado que tem o comentário // #sourceURL com o nome original do arquivo de origem.
  5. Para abrir o arquivo de origem, clique no link na barra de status do Editor.

O comentário "sourceURL" e o link para o arquivo de origem na barra de status.