receita

Receita: Chrome DevTools para performance

Um roteiro de gravação para achar a causa de um LCP lento ou de um INP alto: métricas ao vivo, throttling, trace, insights e Lighthouse.

resposta curtaPara diagnosticar performance no Chrome DevTools, comece pelas métricas ao vivo do painel Desempenho, ative o throttling de CPU e rede, grave com "Gravar e recarregar" para o LCP ou grave a interação para o INP, e leia a aba Insights e a faixa de Interações. O laboratório ajuda a achar a causa; quem decide se a página passou são os dados de campo no percentil 75.
Neste texto

Que problema esta receita resolve?

O relatório de Core Web Vitals do Search Console diz que um grupo de páginas está lento. Não diz por quê. O DevTools do Chrome responde à segunda pergunta: mostra o que o navegador fez, em que ordem e quanto tempo gastou. O risco é tirar conclusão de uma máquina de desenvolvimento rápida, que não representa o celular do visitante. A receita descreve um roteiro que limita esse risco.

O que ela entrega: um procedimento repetível para achar a causa de um LCP lento e de um INP acima de 200 ms, com critério de sucesso por etapa. O que ela não faz: dizer se o site "passou" nos Core Web Vitals. Os limites do web.dev (página "Web Vitals", atualizada em 31 de outubro de 2024) valem para o percentil 75 dos acessos reais: LCP até 2,5 segundos, INP até 200 milissegundos, CLS até 0,1. Uma gravação local é uma amostra de um acesso, em um aparelho.

Quando usar e quando não usar

Use para investigar uma página específica quando você já sabe que há um problema (relatório de campo, reclamação, PageSpeed Insights) ou quando vai mexer em código e quer comparar antes e depois.

Não use como prova de aprovação. Também não use quando o problema está fora da página, como um servidor lento: o trace mostrará a espera, mas a correção é no servidor.

Pré-requisitos

  • Chrome atualizado. A interface muda entre versões; os guias oficiais citados aqui foram escritos para versões diferentes (o tutorial de runtime se baseia no Chrome 129), então confira os nomes dos botões na sua versão.
  • Janela anônima, sem extensões ativas, para que elas não entrem no trace.
  • Uma página real do seu site, de preferência a de maior tráfego do grupo problemático.
  • Nível: iniciante a intermediário.

Passo a passo

  1. 01Abra a página em janela anônima e o painel Desempenho. Critério: você vê as métricas ao vivo de LCP, CLS e INP.
  2. 02Interaja com a página e observe as métricas se atualizarem. Critério: você identifica qual métrica está fora do limite.
  3. 03Configure o throttling antes de gravar. Critério: CPU com lentidão e rede limitada, anotados na sua planilha.
  4. 04Grave. Para LCP, use "Gravar e recarregar"; para INP, grave enquanto repete a interação lenta. Critério: o trace cobre o momento do problema e não passa de alguns segundos.
  5. 05Leia a aba Insights e a faixa de Interações. Critério: você nomeia a parte do LCP que domina ou a fase da interação mais longa.
  6. 06Aprofunde na linha principal (Main). Critério: você encontra a tarefa longa ou o recurso responsável.
  7. 07Corrija uma coisa e grave de novo. Critério: a métrica de laboratório melhora no mesmo cenário.
  8. 08Confirme no campo. Critério: depois de semanas, o relatório de campo mostra a melhora.

Passos 1 e 2: métricas ao vivo

Ao abrir o painel Desempenho, o DevTools mostra um resumo instantâneo dos três Core Web Vitals (LCP, CLS e INP), atualizado enquanto você interage e navega. Segundo a documentação do Chrome (atualizada em 3 de abril de 2025), isso ajuda a encontrar problemas intermitentes de INP ou CLS antes de gravar um trace. Se você ativar a opção de dados de campo, o painel também pode mostrar números do Chrome UX Report (CrUX) e resumir a diferença entre sua medição local e o campo. Quando a diferença é grande, desconfie do cenário local: o aparelho, a rede ou o caminho do usuário são outros.

Passo 3: throttling

Em "Configurações de captura", defina a lentidão da CPU e da rede antes de gravar. O guia do Chrome avisa que a lentidão da CPU é relativa à velocidade do seu computador e, por isso, não simula fielmente um celular. O tutorial de performance de execução usa 4x de lentidão como exemplo, e outra página sugere 20x para aparelhos muito simples. Registre o valor que usou. Sem isso, o "antes" e o "depois" não são comparáveis.

Passo 4: gravar

  • Para o LCP: use "Gravar e recarregar". O DevTools limpa os registros anteriores, recarrega a página e para pouco depois do fim do carregamento.
  • Para o INP: clique em Gravar, execute a interação lenta (abrir o menu, filtrar a lista, adicionar ao carrinho) e pare. O tutorial recomenda gravar poucos segundos e depois ampliar um único evento, porque o trace traz dados demais.

Passo 5: insights e interações

A aba Insights lista problemas como as partes do LCP e do INP, código de terceiros e JavaScript legado. Ao selecionar um insight, os eventos relacionados ficam destacados no trace. A faixa de Interações mostra cada interação dividida em atraso de entrada, tempo de processamento e atraso de apresentação, e marca com um triângulo vermelho as que passam de 200 ms.

Duas leituras de partida:

Sintoma no traceParte provávelPara onde olhar
LCP lento com muito tempo antes de o recurso começaratraso de carregamento do recursodescoberta tardia da imagem, falta de preload; veja a receita de imagens e vídeos
LCP lento com download longoduração do carregamentopeso do arquivo, formato, CDN
Interação lenta com atraso de entrada altotarefa longa em andamentoJavaScript de inicialização, scripts de terceiros
Interação lenta com processamento altoouvintes de evento pesadostrabalho feito dentro do clique
Interação lenta com apresentação altarenderização depois do ouvinteDOM grande, muito HTML gerado por JavaScript

As partes do LCP e as proporções-guia estão no artigo "Optimize Largest Contentful Paint" (web.dev, 31 de março de 2025): tempo até o primeiro byte, atraso de carregamento do recurso, duração do carregamento e atraso de renderização do elemento. As três fases do INP seguem o artigo "Optimize Interaction to Next Paint" (2 de setembro de 2025): atraso de entrada, duração do processamento e atraso de apresentação.

Passo 6: a linha principal

Na seção Main, o gráfico em chamas mostra a atividade da linha de execução principal: barras mais largas são eventos mais longos, e eventos empilhados mostram causa e efeito. Uma tarefa longa recebe um triângulo vermelho. Avisos de reflow forçado aparecem em eventos de Layout, e a aba Resumo (Summary) liga ao código que o causou. O artigo de INP do web.dev cita o mesmo padrão como sinal de layout thrashing: triângulo vermelho em "Recalculate Style" ou "Layout".

As correções recomendadas no artigo, em resumo:

  • reduzir o trabalho de script na inicialização, para a linha principal estar livre quando a pessoa clicar;
  • fazer o mínimo dentro do ouvinte de evento e quebrar trabalho longo cedendo a linha principal (por exemplo, com setTimeout);
  • evitar ler estilo dependente de layout logo depois de alterá-lo na mesma tarefa;
  • manter o DOM pequeno e considerar content-visibility para renderizar sob demanda o que está fora da tela.

Passo 7: o Lighthouse como complemento

O Lighthouse é uma ferramenta de código aberto que audita a qualidade de páginas. No DevTools, a aba Lighthouse tem o botão "Analyze page load", e a execução leva de 30 a 60 segundos, segundo a documentação (2 de junho de 2025). Ele roda no terminal com lighthouse <url> e exige o Chrome instalado. A página lista as categorias Performance, Accessibility, Best Practices, SEO e uma chamada "Agentic browsing"; esta receita usa só a de Performance. O Lighthouse testa o carregamento: quem mede interações é o painel Desempenho e, no campo, o CrUX ou uma coleta própria, como na receita do monitor de INP.

Exemplo de uso (simulação)

Exemplo hipotético, sem site real. Uma loja fictícia recebe no Search Console o aviso de INP acima de 200 ms nas páginas de categoria. A analista abre uma categoria em janela anônima, ativa 4x de lentidão de CPU e grava um clique em "Filtrar por preço". Na faixa de Interações, o triângulo vermelho está sobre o clique e o maior trecho é o tempo de processamento. Na linha principal, o ouvinte do filtro recalcula a lista inteira e depois lê as dimensões de cada cartão, acionando reflow forçado.

Ela muda o código para atualizar a lista em um único passo, adia a leitura de dimensões e grava de novo, com a mesma lentidão. O triângulo desaparece da gravação local. Só depois de algumas semanas os dados de campo dirão se o grupo de páginas melhorou.

Como testar

Critério de sucesso: no mesmo cenário (mesma página, mesma lentidão, mesma interação), a métrica de laboratório melhora; em algumas semanas, o campo confirma.

  1. Faça três gravações do cenário antes de mudar nada e use a mediana, porque uma gravação isolada varia.
  2. Mude uma coisa. Grave três vezes de novo.
  3. Compare LCP ou a duração da interação, e anote em uma tabela (data, página, lentidão de CPU, métrica, mudança feita).
  4. Repita o teste em uma segunda página do mesmo grupo.
  5. Acompanhe o relatório de campo por semanas.

Erros comuns e como desfazer

ErroEfeitoCorreção
Gravar com extensões ativastrace poluídouse janela anônima
Comparar gravações com lentidão diferenteconclusão falsaregistre e repita o valor
Declarar vitória pelo LighthouseINP não é testado no carregamentoconfirme com interação real e com o campo
Gravar por tempo demaistrace ilegívelgrave poucos segundos e amplie um evento
Mudar várias coisas de uma vezcausa desconhecidauma mudança por gravação
Ignorar a diferença entre local e campootimização para o cenário erradoveja o painel de dados de campo e o CrUX

Para desfazer, reverta a alteração de código e grave de novo: o trace deve voltar ao estado anterior.

Checklist final

  • Janela anônima e sem extensões.
  • Lentidão de CPU e rede registrada.
  • LCP gravado com "Gravar e recarregar"; INP gravado na interação.
  • Parte do LCP ou fase do INP nomeada.
  • Uma mudança por vez e medição repetida.
  • Confirmação nos dados de campo.

Para aprofundar

O mini-curso Core Web Vitals no campo ensina a decidir o que investigar a partir do dado real, e a formação Core Web Vitals cobre o processo inteiro. O pilar técnico está em Core Web Vitals no nível extremo, e o verbete INP resume a métrica.

Fontes

  1. Performance panel reference, Chrome for Developers (2025-04-03)
  2. Analyze runtime performance, Chrome for Developers (2024-10-23)
  3. Lighthouse overview, Chrome for Developers (2025-06-02)
  4. Interaction to Next Paint (INP), web.dev (2025-09-02)
  5. Optimize Interaction to Next Paint, web.dev (2025-09-02)
  6. Optimize Largest Contentful Paint, web.dev (2025-03-31)
  7. Web Vitals, web.dev (2024-10-31)

Não sabe por onde começar?

Compare as opções e escolha a trilha pelo seu objetivo.