Identificar e corrigir problemas de Interaction to Next Paint (INP)

Do problema de INP a vermelho no Search Console ao clique lento, ao script por trás dele e à linha de código que o resolve.

  • Bom ≤ 200 ms
  • Precisa de melhorias ≤ 500 ms
  • Mau > 500 ms
Arjen Karel
Atualizado a · 11 min de leitura
Partilhar

Identificar e corrigir problemas de INP em resumo

Por trás de cada problema de Interaction to Next Paint (INP) está uma interação lenta. Encontre-a nos telemóveis em dados de utilizadores reais (o patamar bom é de 200 ms ou menos no percentil 75), veja se ocorre enquanto a página ainda está a carregar, reproduza-a no Chrome com o CPU abrandado e resolva-a encurtando a mais longa das suas três subpartes: input delay, processing duration ou presentation delay.

Passo 1: Verificar problemas de INP no Search Console

O relatório de Core Web Vitals do Search Console mostra "INP issue: longer than 200ms (mobile)" para um grupo de URLs semelhantes cujo INP foi superior a 200 ms no percentil 75 das visitas em telemóveis nos últimos 28 dias, e "INP issue: longer than 500ms (mobile)" quando superou os 500 ms. A maioria dos problemas de INP surge nos telemóveis, por isso abra primeiro o relatório de dispositivos móveis.

Todos os URLs de um grupo partilham o mesmo valor: abra o grupo maior e teste os URLs de exemplo listados por baixo. O guia de INP explica o limiar e o percentil 75.

Google Search Console, relatório de Core Web Vitals em dispositivos móveis para acme-inp.com: INP issue: longer than 200ms (mobile), precisa de melhoria, 1.240 URLs afetados, a subir ao longo de três meses

Para verificar o INP online gratuitamente, analise o URL no PageSpeed Insights: os field data no topo mostram o INP de visitantes reais no Chrome ao longo de 28 dias para esse URL, ou para todo o site caso o URL tenha poucas visitas. O teste de laboratório por baixo não tem INP, porque o Lighthouse nunca clica. O relatório gratuito de Core Web Vitals com base no histórico do CrUX mostra os mesmos field data semana a semana durante 25 semanas, para que veja quando o INP piorou.

Passo 2: Identificar as interações por trás dos problemas de INP

O Search Console indica que grupos de URLs falham. Antes de alterar código, precisa de mais quatro respostas: que elemento foi clicado, em que momento do carregamento da página, em que páginas e dispositivos, e que script correu durante o clique. A maioria dos developers salta este passo e começa logo a remover JavaScript não utilizado e a dividir long tasks. Ambas são boas ideias, mas sozinhas quase nunca resolvem o INP.

Medir o INP em visitantes reais

Um script de real-user monitoring (RUM) regista o INP de utilizadores reais e mostra o que está a causar interações lentas: para cada visita, grava o elemento clicado, o momento do carregamento da página e quanto tempo demorou cada subparte. Envie estes dados para o seu analytics com a biblioteca web-vitals da Google (económico, mas terá de criar o armazenamento e os gráficos por sua conta), ou utilize uma ferramenta de RUM. Criei o CoreDash precisamente para isto.

Para developers, este snippet envia tudo a partir da build de attribution da web-vitals para o seu endpoint:

<script type="module">
  import { onINP } from 'https://unpkg.com/web-vitals@6/dist/web-vitals.attribution.js?module';

  onINP(({ value, attribution: a }) => {
    navigator.sendBeacon('/rum', JSON.stringify({
      page: location.pathname,
      inp: value,
      element: a.interactionTarget,
      type: a.interactionType,
      loadState: a.loadState,
      inputDelay: a.inputDelay,
      processing: a.processingDuration,
      presentation: a.presentationDelay,
      script: a.longestScript?.entry.sourceURL,
      scriptSubpart: a.longestScript?.subpart
    }));
  });
</script>

Que elemento é lento?

Agrupe o INP em telemóveis pelo elemento clicado e comece pelo topo: o elemento com o pior INP com volume suficiente de visitantes. No CoreDash, abra INP, agrupe por elemento e clique no mais lento: todos os números passam a mostrar apenas as interações com esse elemento.

O elemento surge como um seletor, como button.add-to-cart, que um developer encontra facilmente no HTML. Um INP fraco deve-se frequentemente a mais do que um elemento: resolva o pior e volte a analisar a lista.

O clique lento acontece durante o carregamento?

O INP costuma ser muito pior quando o visitante toca no ecrã enquanto a página ainda está a carregar, por isso consulte o estado de carregamento de cada interação lenta. Nos telemóveis, entre os sites que recolhem dados com o CoreDash nos 28 dias até 7 de novembro de 2026, o INP foi de 285 ms no percentil 75 durante o carregamento contra 158 ms depois dele, e só o input delay foi de 96 contra 29 ms: o toque ficou à espera de scripts que ainda estavam a correr.

A web-vitals indica loading, dom-interactive ou dom-content-loaded para um clique durante o carregamento e complete para um clique após este.

Um clique lento nos primeiros três estados aponta para o que corre durante o carregamento: um script que ainda não é necessário, uma framework que ainda está a hidratar, ou um campo de pesquisa ou menu visível antes de o respetivo script ter carregado. Um toque prematuro nesses elementos não faz nada, mas fica à espera dos scripts em execução — e essa espera conta para o INP. Links, formulários e um <dialog> aberto com os atributos command e commandfor funcionam sem JavaScript, pelo que não necessitam de hidratação, embora continuem a ter de esperar por um script que esteja a correr.

Em que páginas e dispositivos?

Agrupe o elemento lento por página. Um clique lento num único template, como a página de produto, aponta para os scripts desse template. O mesmo clique lento em todas as páginas aponta para algo transversal a todo o site: um tag manager, um banner de consentimento ou o script principal do tema.

Depois, observe de que dispositivos vêm os cliques lentos: quase sempre telemóveis e, entre eles, os que têm pouca memória e poucos núcleos de CPU.

Que script corre durante a interação lenta?

A API Long Animation Frames (LoAF) regista quais os scripts que correram em cada frame que demorou mais de 50 ms, com indicação do ficheiro e da função (apenas no Chrome). Assim, uma interação lenta nos field data passa a ter o nome do script associado. A build de attribution da web-vitals coloca o mais longo desses scripts em longestScript, com a subparte em que foi executado.

No CoreDash, abra INP, Breakdown e agrupe por LOAF: cada linha representa um script com o INP das interações em que correu, dividido pelas três subpartes.

Subpartes de INP por LOAF no CoreDash: p75 de INP por script, cada um dividido em input delay, processing e presentation.

Verde é o input delay, roxo a processing duration, azul o presentation delay (aqui em desktop; filtre por mobile para ver os visitantes em telemóveis).

O proprietário do ficheiro dita quem o vai corrigir: o seu tema, um plugin, uma app Shopify ou uma tag no tag manager. Quando uma tag de terceiros processa trabalho a mais durante o clique, a solução raramente passa por remover a tag: transfira esse trabalho para depois de o ecrã ter atualizado. O guia de Long Animation Frames explica cada campo de uma entrada.

Passo 3: Reproduzir, testar e fazer debug da interação lenta

Uma interação lenta só se manifesta no seu próprio computador se o CPU for tão lento quanto o de um telemóvel e se clicar no mesmo elemento no mesmo momento do carregamento. É por isso que o site lhe parece rápido.

Abrandar o computador para o nível de um telemóvel

Nas Chrome DevTools, ative o CPU throttling no painel Performance. O menu inclui a opção Calibrate, que avalia a velocidade do computador e adiciona predefinições para telemóveis de gama média (mid-tier) e gama baixa (low-tier); sem ela, use 4x, o abrandamento que o Lighthouse aplica para fazer um desktop rápido comportar-se como um telemóvel de gama média. Use o preset low-tier quando os cliques lentos vierem de telemóveis com pouca memória e poucos núcleos de CPU.

O network throttling só é relevante para cliques lentos durante o carregamento: uma ligação mais lenta dá-lhe tempo para clicar enquanto a página carrega.

Clicar no elemento certo no momento certo

O painel Performance abre nas live metrics, uma ferramenta gratuita de diagnóstico e debug de INP para os seus próprios cliques: mostra o INP da sua sessão à medida que clica, com um registo de cada interação e o respetivo input delay, processing duration e presentation delay. A Core Web Vitals Visualizer, uma extensão gratuita para o Chrome da corewebvitals.io, funciona como testador de INP na própria página, com o mesmo breakdown.

Recarregue a página e clique no elemento certo no momento certo. Se os seus dados de RUM indicarem que os cliques lentos acontecem durante o carregamento, clique enquanto a página ainda está a carregar. Quando o seu INP estiver na mesma ordem de grandeza dos field data, significa que está a testar o cenário certo.

Gravar uma trace e analisar o breakdown de INP

Uma trace mostra o que correu durante o clique lento. No painel Performance, clique em Record, execute o clique e pare a gravação; para um clique durante o carregamento, use Record and reload e clique enquanto a página carrega. A track Interactions assinala a interação, e o insight INP breakdown apresenta as três subpartes em milissegundos.

Painel Performance das Chrome DevTools, um toque numa página de teste: INP de 379 ms, breakdown de INP com 1 ms de input delay, 369 ms de processing duration e 9 ms de presentation delay

Um toque numa página de teste: 379 ms na trace, 320 ms sem ela, porque a gravação torna o toque mais lento. Compare uma trace apenas com outra trace.

Na track Main, por baixo da interação, as tarefas anteriores ao arranque do event handler correspondem ao input delay. O handler e tudo o que este invoca, incluindo o layout forçado pelo próprio handler, constituem a processing duration. O style, layout e paint após o handler são o presentation delay. O guia sobre gravar uma trace explica as configurações passo a passo.

Passo 4: Corrigir problemas de INP

A resolução de um problema de INP depende da subparte mais longa da interação lenta: para um input delay longo, menos JavaScript a correr quando o visitante toca no ecrã; para uma processing duration longa, menos trabalho antes de o ecrã mudar; para um presentation delay longo, menos conteúdo para renderizar.

Num toque lento, o visitante costuma esperar mais tempo antes sequer de o click handler arrancar. Entre os sites que medem dados com o CoreDash, as interações em telemóveis com um INP igual ou superior a 500 ms registaram uma mediana de input delay de cerca de 210 ms nos 28 dias até 7 de novembro de 2026, contra cerca de 120 ms de processing e 140 ms de presentation. São medianas por subparte, pelo que os valores não se somam diretamente.

Sem alterar código, comece pelos plugins e pelas apps que correm durante o toque: desative plugins do WordPress ou app embeds no editor de temas do Shopify, um a um, repetindo o toque lento após cada um. O que sobrar é trabalho para um developer: passe-lhe o elemento, o estado de carregamento, o script e a subparte mais longa; os blocos abaixo apresentam a solução para cada um.

Quando o código é seu, fazer yielding (devolver o controlo da main thread ao browser) encurta as duas primeiras subpartes: numa long task, dá passagem a um toque que esteja em espera; num handler, permite que o ecrã atualize antes de o resto correr. Esta função auxiliar faz yield com scheduler.yield() no Chrome e no Firefox e com setTimeout no Safari:

async function yieldToMain() {
  if ('scheduler' in window && 'yield' in window.scheduler) {
    return await window.scheduler.yield();
  }
  return new Promise((resolve) => {
    setTimeout(resolve, 0);
  });
}

// Utilização num event handler
async function handleButtonClick() {
  // Trabalho crítico: atualizar a UI
  updateVisualFeedback();

  // Fazer yield para o browser renderizar o paint
  await yieldToMain();

  // Trabalho não crítico: analytics, logging
  sendAnalyticsEvent('button_click');
  logInteraction();
}

O guia de INP disponibiliza o código para cada subparte.

Input delay: menos JavaScript enquanto o visitante toca no ecrã

Um input delay longo significa que a main thread estava ocupada com outro script quando o toque ocorreu. Localize-o na trace ou na LoAF e remova-o, ou execute-o apenas após o carregamento da página.

No WordPress, impeça o carregamento de scripts de plugins nas páginas que não os utilizam, através do Script Manager do Perfmatters ou do Asset CleanUp. Mantenha desativada a opção Delay JavaScript dos plugins de cache: executa todos os scripts adiados logo ao primeiro toque, e esse toque conta para o INP. Para um developer: faça yield após cerca de 50 ms de processamento, inicie um widget de chat apenas após o evento load e mantenha o elemento desativado até o respetivo script estar a funcionar. Saiba mais em input delay e 16 métodos para adiar ou agendar JavaScript.

Processing duration: atualizar primeiro o ecrã

Uma processing duration longa reside no próprio event handler. Deixe-o alterar primeiro aquilo que o visitante vê e transfira todo o restante trabalho para depois do próximo paint, com a função auxiliar yieldToMain() acima. O tracking é o trabalho típico a adiar: um dataLayer.push() após a atualização do ecrã continua a enviar o evento (agendar eventos no dataLayer).

Não utilize requestIdleCallback() para esse trabalho: o Safari não o tem, pelo que o handler gera um erro em qualquer iPhone. Um handler que altera a página e logo a seguir lê uma dimensão obriga o browser a recalcular o layout dentro do clique: leia todas as dimensões primeiro e só depois faça as alterações (forced reflow). Num botão de adicionar ao carrinho ou num formulário que aguarda pelo servidor, mostre "A adicionar..." de imediato e deixe o pedido terminar a seguir. Saiba mais em processing time.

Presentation delay: menos conteúdo para renderizar

Um presentation delay longo reside no style, layout e paint após o handler. Um DOM excessivo torna cada frame mais lenta (como reduzir a dimensão do DOM). Em páginas compridas, content-visibility: auto permite ao browser ignorar secções fora do ecrã; atribua a cada uma um contain-intrinsic-size próximo da sua altura real, para evitar que a barra de scroll salte. Uma animação em JavaScript compete com cada clique pela main thread: um único script esquecido de smooth-scroll pode acrescentar 200 ms a qualquer clique em todas as páginas (abandone o scroll em JavaScript). Saiba mais em presentation delay.

Passo 5: Confirmar que a correção de INP funcionou

Repita o mesmo clique com o mesmo CPU throttling e compare as três subpartes: uma correção pode simplesmente transferir a espera para outra subparte em vez de a eliminar.

Numa página de teste com a estrutura de um anúncio de alojamento para férias em WordPress, um toque no filtro "All" demorou 320 ms, 298 ms dos quais em layout forçado pelo script do tema. Com o script a ler todas as alturas primeiro, o mesmo toque demorou 16 ms, um único frame. Ambas as medições foram feitas no Chrome, com a largura de um telemóvel e o CPU abrandado a 4x.

Para visitantes reais, filtre os dados de RUM pelo elemento e pelas páginas alteradas, em mobile: a diferença reflete-se dentro de um ou dois dias. No Search Console, clique em Validate fix no problema correspondente. O relatório abrange os últimos 28 dias de visitas, pelo que demora até 28 dias a ficar verde.

Alguns problemas de INP persistem: o toque lento corre numa app, numa tag ou num banner de consentimento que não consegue alterar, ou a espera desloca-se para outra subparte após cada alteração. Numa power hour de Core Web Vitals, comparamos o elemento mais lento dos seus field data com uma trace desse toque, e sai de lá com a alteração exata a fazer e a indicação de quem a deve implementar.

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Precisa de um site mais rápido?

Sou o Arjen e há 17 anos que corrijo sites lentos. Se tem problemas que não consegue resolver sozinho, envie-me o seu URL e falamos.

Envie-me o seu URL
Arjen Karel
Arjen Karel, Consultor de web performance desde 2009

Porque é que o nosso fix não está a funcionar?

Por vezes a CDN ainda serve o HTML antigo, ou o fix foi feito no template de desktop e o mobile usa outro. Envie-me o seu URL e o problema, e respondo com alguns horários. Primeiro analiso os seus field data, depois dedicamos uma hora ao seu site, e no prazo de um dia tem as minhas notas por escrito. 350 € sem IVA.

Envie-me o seu URL

Sem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.

Arjen KarelINP ainda no vermelho em mobile?Envie-me o seu URL