Referência da depuração do JavaScript

Kayce Basques

Sofia Emelianova

Descubra novos fluxos de trabalho de depuração com esta referência abrangente dos recursos de depuração do Chrome DevTools.

Consulte Introdução à depuração de JavaScript no Chrome DevTools para aprender os conceitos básicos da depuração.

Pausar o código com pontos de interrupção

Defina um ponto de interrupção para pausar o código no meio da execução. Para saber como definir pontos de interrupção, consulte Pausar o código com pontos de interrupção.

Verificar valores quando pausado

Enquanto a execução está pausada, o depurador avalia todas as variáveis, constantes e objetos na função atual até um ponto de interrupção. O depurador mostra os valores atuais inline ao lado das declarações correspondentes.

É possível usar o Console para consultar as variáveis, constantes e objetos avaliados.

Visualizar as propriedades de classe/função ao passar o cursor

Enquanto a execução está pausada, passe o cursor sobre o nome de uma classe ou função para conferir as propriedades dela.

Percorrer o código

Quando o código estiver pausado, percorra-o, uma expressão de cada vez, investigando o fluxo de controle e os valores de propriedade.

Pular linha de código

Quando estiver pausado em uma linha de código que contém uma função que não é relevante para o problema que você está depuração, clique em Step over para executar a função sem entrar nela.

Por exemplo, suponha que você esteja depurando o seguinte código:

function updateHeader() {
  var day = new Date().getDay();
  var name = getName(); // A
  updateName(name); // D
}
function getName() {
  var name = app.first + ' ' + app.last; // B
  return name; // C
}

Você está pausado em A. Ao pressionar Step over, o DevTools executa todo o código na função que você está percorrendo, que é B e C. O DevTools pausa em D.

Entrar em uma linha de código

Quando pausado em uma linha de código que contém uma chamada de função relacionada ao problema que você está depurando, clique em Entrar para investigar melhor essa função.

Por exemplo, suponha que você esteja depurando o seguinte código:

function updateHeader() {
  var day = new Date().getDay();
  var name = getName(); // A
  updateName(name);
}
function getName() {
  var name = app.first + ' ' + app.last; // B
  return name;
}

Sua conta está pausada em A. Ao pressionar Step into, o DevTools executa essa linha de código e faz uma pausa em B.

Sair da linha de código

Quando estiver pausado em uma função que não está relacionada ao problema que você está depurando, clique em Step out para executar o restante do código da função.

Por exemplo, suponha que você esteja depurando o seguinte código:

function updateHeader() {
  var day = new Date().getDay();
  var name = getName();
  updateName(name); // C
}
function getName() {
  var name = app.first + ' ' + app.last; // A
  return name; // B
}

Sua conta está pausada em A. Ao pressionar Step out, o DevTools executa o restante do código em getName(), que é apenas B neste exemplo, e depois pausa em C.

Executar todo o código até uma determinada linha

Ao depurar uma função longa, pode haver muito código que não está relacionado ao problema que você está depurando.

Você poderia percorrer todas as linhas, mas isso pode ser entediante. Você pode definir um ponto de interrupção na linha de código na linha do seu interesse e pressionar Resume Script Execution , mas há uma maneira mais rápida.

Clique com o botão direito do mouse na linha de código de seu interesse e selecione Continuar até aqui. O DevTools executa todo o código até esse ponto e depois pausa nessa linha.

Retomar a execução do script

Para continuar a execução do script após uma pausa, clique em Retomar execução do script . As Ferramentas do desenvolvedor executam o script até o próximo ponto de interrupção, se houver.

Forçar a execução do script

Para ignorar todos os pontos de interrupção e forçar o script a retomar a execução, clique e mantenha pressionada a opção Resume Script Execution e selecione Forçar execução do script .

Mudar o contexto da linha de execução

Ao trabalhar com web workers ou service workers, clique em um contexto listado no painel Threads para alternar para esse contexto. O ícone de seta azul representa o contexto selecionado.

O painel Threads na captura de tela acima está destacado em azul.

Por exemplo, suponha que você esteja pausado em um ponto de interrupção no script principal e no script do worker de serviço. Você quer visualizar as propriedades locais e globais para o contexto do service worker, mas o painel Origens está mostrando o contexto do script principal. Ao clicar na entrada do service worker no painel "Threads", é possível alternar para esse contexto.

Executar expressões separadas por vírgulas

A execução de expressões separadas por vírgulas permite depurar o código minificado. Por exemplo, considere o seguinte código:

function foo() {}

function bar() {
  foo();
  foo();
  return 42;
}

bar();

Quando minimizado, ele contém uma expressão foo(),foo(),42 separada por vírgulas:

function foo(){}function bar(){return foo(),foo(),42}bar();

O depurar percorre essas expressões da mesma forma.

Portanto, o comportamento da etapa é idêntico:

• entre código minificado e criado;
• Ao usar mapas de origem para depurar o código reduzido em termos do código original. Em outras palavras, quando você encontrar pontos e vírgulas, poderá sempre seguir por eles, mesmo que a origem que você está depurando esteja minimizada.

Acessar e editar propriedades locais, de fechamento e globais

Enquanto estiver pausado em uma linha de código, use o painel Scope para conferir e editar os valores de propriedades e variáveis nos escopos local, de fechamento e global.

• Clique duas vezes em um valor de propriedade para mudá-lo.
• As propriedades não enumeráveis ficam esmaecidas.

O painel Escopo na captura de tela acima está delineado em azul.

Conferir a pilha de chamadas atual

Enquanto estiver pausado em uma linha de código, use o painel Pilha de chamadas para visualizar a pilha de chamadas que levou você a este ponto.

Clique em uma entrada para ir para a linha de código em que a função foi chamada. O ícone de seta azul representa qual função o DevTools está destacando.

O painel Call Stack na captura de tela acima está destacado em azul.

Reiniciar uma função (frame) em uma pilha de chamadas

Para observar o comportamento de uma função e executá-la novamente sem ter que reiniciar todo o fluxo de depuração, reinicie a execução de uma única função quando ela estiver pausada. Em outras palavras, é possível reiniciar o frame da função na pilha de chamadas.

Para reiniciar um frame:

1. Pausar a execução da função em um ponto de interrupção. O painel Pilha de chamadas registra a ordem das chamadas de função.

2. No painel Call Stack, clique com o botão direito do mouse em uma função e selecione Restart frame no menu suspenso.

   

Para entender como o Restart frame funciona, considere o seguinte código:

function foo(value) {
    console.log(value);
    bar(value);
}

function bar(value) {
    value++;
    console.log(value);
    debugger;
}

foo(0);

A função foo() usa 0 como argumento, o registra e chama a função bar(). A função bar(), por sua vez, incrementa o argumento.

Tente reiniciar os frames das duas funções da seguinte maneira:

1. Copie o código acima para um novo snippet e execute-o. A execução é interrompida no ponto de interrupção da linha de código debugger.
2. O depurador mostra o valor atual ao lado da declaração da função: value = 1.
3. Reinicie o frame bar().
4. Percorra a instrução de incremento de valor pressionando F9. Observe que o valor atual aumenta: value = 2.
5. Como alternativa, no painel Escopo, clique duas vezes no valor para editá-lo e definir o valor desejado.

6. Tente reiniciar o frame bar() e percorrer a instrução de incremento várias vezes. O valor continua aumentando.

A reinicialização do frame não redefine os argumentos. Em outras palavras, a reinicialização não restaura o estado inicial na chamada de função. Em vez disso, ele simplesmente move o ponteiro de execução para o início da função.

Portanto, o valor do argumento atual persiste na memória entre as reinicializações da mesma função.

1. Agora, reinicie o frame foo() na pilha de chamadas. Observe que o valor é 0 novamente.

Em JavaScript, as alterações em argumentos não são visíveis (refletidas) fora da função. As funções aninhadas recebem valores, não os locais delas na memória. 1. Retome a execução do script (F8) para concluir este tutorial.

Mostrar frames na lista de ignorados

Por padrão, o painel Call Stack mostra apenas os frames relevantes para o código e omite todos os scripts adicionados a Settings > Ignore List.

Para conferir a pilha de chamadas completa, incluindo frames de terceiros, ative a opção Mostrar frames ignorados na seção Pilha de chamadas.

Teste nesta página de demonstração:

1. No painel Fontes, abra o arquivo src > app > app.component.ts.
2. Defina um ponto de interrupção na função increment().
3. Na seção Pilha de chamadas, marque ou desmarque a caixa de seleção Mostrar frames ignorados e observe a lista completa ou relevante de frames na pilha de chamadas.

Conferir frames assíncronos

Se o framework que você está usando oferece suporte, o DevTools pode rastrear operações assíncronas vinculando as duas partes do código.

Nesse caso, Call Stack mostra todo o histórico de chamadas, incluindo frames de chamadas assíncronas.

Copiar stack trace

Clique com o botão direito do mouse em qualquer lugar do painel Call Stack e selecione Copy stack trace para copiar a pilha de chamadas atual para a área de transferência.

Confira abaixo um exemplo da saída:

getNumber1 (get-started.js:35)
inputsAreEmpty (get-started.js:22)
onClick (get-started.js:15)

Navegar pela árvore de arquivos

Use o painel Page para navegar na árvore de arquivos.

Agrupar arquivos criados e implantados na árvore de arquivos

Ao desenvolver aplicativos da Web usando frameworks (por exemplo, React ou Angular), pode ser difícil navegar pelas fontes devido aos arquivos minificados gerados pelas ferramentas de build (por exemplo, webpack ou Vite).

Para ajudar você a navegar pelas fontes, o painel Origens > Página pode agrupar os arquivos em duas categorias:

• Autorizado. Semelhante aos arquivos de origem que você acessa no seu ambiente de desenvolvimento integrado. O DevTools gera esses arquivos com base nos mapas de origem fornecidos pelas ferramentas de build.
• Implantado. Os arquivos que o navegador lê. Normalmente, esses arquivos são minimizados.

Para ativar o agrupamento, selecione a opção > Agrupar arquivos por autor/implantação no menu de três pontos na parte de cima da árvore de arquivos.

Ocultar fontes da lista de ignorados da árvore de arquivos

Para ajudar você a se concentrar apenas no código criado, o painel Origens > Página desativa todos os scripts ou diretórios adicionados a Configurações > Lista de ignorados por padrão.

Para ocultar esses scripts, selecione Origens > Página > > Ocultar origens ignoradas .

Ignorar um script ou padrão de scripts

Ignorar um script para pular durante a depuração. Quando ignorado, um script é obscurecido no painel Pilha de chamadas, e você nunca entra nas funções do script ao percorrer o código.

Por exemplo, suponha que você esteja percorrendo este código:

function animate() {
  prepare();
  lib.doFancyStuff(); // A
  render();
}

A é uma biblioteca de terceiros confiável. Se você tiver certeza de que o problema que está debugando não está relacionado à biblioteca de terceiros, faça sentido ignorar o script.

Ignorar um script ou diretório da árvore de arquivos

Para ignorar um script individual ou um diretório inteiro:

1. Em Sources > Page, clique com o botão direito do mouse em um diretório ou arquivo de script.
2. Selecione Add directory/script to ignore list.

Se você não ocultou as origens na lista de ignorados, pode selecioná-las na árvore de arquivos e, no banner de aviso , clicar em Remover da lista de ignorados ou Configurar.

Caso contrário, remova da lista diretórios e scripts ocultos e ignorados em Configurações > Lista de ignorados.

Ignorar um script no painel do Editor

Para ignorar um script do painel Editor:

1. Abra o arquivo.
2. Clique com o botão direito do mouse em qualquer lugar.
3. Selecione Adicionar script para ignorar lista.

É possível remover um script da lista de ignorados em Configurações > Lista de ignorados.

Ignorar um script do painel "Pilha de chamadas"

Para ignorar um script do painel Pilha de chamadas:

1. Clique com o botão direito do mouse em uma função do script.
2. Selecione Adicionar script para ignorar lista.

É possível remover um script da lista de ignorados em Configurações > Lista de ignorados.

Ignorar um script nas Configurações

Consulte Configurações > Lista de ignorados.

Executar snippets de código de depuração em qualquer página

Se você estiver executando o mesmo código de depuração no console várias vezes, considere usar os snippets. Os snippets são scripts executáveis que você cria, armazena e executa no DevTools.

Consulte Executar snippets de código em qualquer página para saber mais.

Observar os valores das expressões JavaScript personalizadas

Use o painel "Observar" para conferir os valores das expressões personalizadas. É possível monitorar qualquer expressão JavaScript válida.

• Clique em Adicionar expressão para criar uma nova expressão de relógio.
• Clique em Atualizar para atualizar os valores de todas as expressões. Os valores são atualizados automaticamente ao percorrer o código.
• Passe o cursor sobre uma expressão e clique em Excluir expressão para excluir.

Inspecionar e editar scripts

Ao abrir um script no painel Página, o DevTools mostra o conteúdo dele no painel Editor. No painel Editor, você pode procurar e editar seu código.

Além disso, é possível substituir o conteúdo localmente ou criar um espaço de trabalho e salvar as mudanças feitas no DevTools diretamente nas suas fontes locais.

Tornar um arquivo reduzido legível

Por padrão, o painel Sources mostra os arquivos minificados. Quando impresso, o Editor pode mostrar uma única linha de código longa em várias linhas, com - para indicar que é a continuação da linha.

Para conferir o arquivo minimizado conforme ele foi carregado, clique em { } no canto inferior esquerdo do Editor.

Dobrar blocos de código

Para dobrar um bloco de código, passe o cursor sobre o número da linha na coluna à esquerda e clique em Recolher.

Para desdobrar o bloco de código, clique no {...} ao lado dele.

Para configurar esse comportamento, consulte Configurações > Preferências > Origens.

Editar um script

Ao corrigir um bug, muitas vezes você quer testar algumas mudanças no código JavaScript. Não é necessário fazer as mudanças em um navegador externo e depois recarregar a página. Você pode editar seu script no DevTools.

Para editar um script:

1. Abra o arquivo no painel Editor do painel Sources.
2. Faça as mudanças no painel Editor.

3. Pressione Command+S (Mac) ou Ctrl+S (Windows, Linux) para salvar. O DevTools aplica patches a todo o arquivo JS no mecanismo JavaScript do Chrome.

   

   O painel Editor na captura de tela acima está destacado em azul.

Editar uma função pausada ao vivo

Enquanto a execução está pausada, você pode editar a função atual e aplicar as mudanças em tempo real com as seguintes limitações:

• Você pode editar apenas a função superior na pilha de chamadas.
• Não pode haver chamadas recursivas para a mesma função mais abaixo na pilha.

Para editar uma função em tempo real:

1. Pausar a execução com um ponto de interrupção.
2. Edite a função pausada.
3. Pressione Command / Control + S para aplicar as mudanças. O depurador reinicia a função automaticamente.
4. Continue a execução.

Assista o vídeo abaixo para saber mais sobre esse fluxo de trabalho.

Neste exemplo, as variáveis addend1 e addend2 têm um tipo string incorreto. Em vez de adicionar números, as strings são concatenadas. Para corrigir isso, as funções parseInt() são adicionadas durante a edição em tempo real.

Pesquisar e substituir texto em um script

Para pesquisar texto em um script:

1. Abra o arquivo no painel Editor do painel Origens.
2. Para abrir uma barra de pesquisa integrada, pressione Command+F (Mac) ou Ctrl+F (Windows, Linux).
3. Na barra, digite sua consulta. Você também pode:
   • Clique em Match Case para que a consulta faça distinção entre maiúsculas e minúsculas.
   • Clique em Usar expressão regular para pesquisar usando uma expressão RegEx.
4. Pressione Enter. Para ir para o resultado da pesquisa anterior ou seguinte, pressione o botão para cima ou para baixo.

Para substituir o texto encontrado:

1. Na barra de pesquisa, clique no botão Substituir.
2. Digite o texto a ser substituído e clique em Substituir ou Substituir tudo.

Desativar o JavaScript

Consulte Desativar o JavaScript com o Chrome DevTools.