WP Rocket Delay JavaScript Quebra o Site: Como Corrigir

Tipo Performance & Velocidade

Nome do erro Delay JavaScript do WP Rocket quebra funções EN: WP Rocket Delay JavaScript breaking site functions

Severidade Grave

Descrição O WP Rocket Delay JavaScript adia a execução de scripts até a primeira interação do usuário. Quando atrasa um script essencial (slider, menu, formulário ou botão), esses elementos param de funcionar até alguém mexer na página. A correção é excluir o script específico do delay, sem desligar a otimização toda.

O que é WP Rocket Delay JavaScript que quebra o site?

O Delay JavaScript Execution é uma otimização do WP Rocket, na aba File Optimization, que adia o carregamento de TODO o JavaScript da página até a primeira interação do usuário (movimento do mouse, toque, rolagem ou tecla). Isso melhora First Contentful Paint e Total Blocking Time, mas atrasa scripts que precisam rodar no carregamento. Quando o script de um slider, menu, formulário ou botão é adiado, o elemento aparece quebrado, congelado ou inerte até o visitante interagir com a página. O problema não é um bug do plugin: é o efeito esperado do delay sobre um script que não suporta ser adiado. A solução é excluir apenas esse script do delay, mantendo o ganho de performance no resto da página.

Como identificar

Slider, carrossel ou banner aparece travado e só anima depois que o visitante move o mouse ou rola a página
Botão de menu hamburguer não abre no primeiro clique, mas passa a funcionar após qualquer interação
Formulário de contato (Contact Form 7, WPForms) não envia ou não valida os campos no primeiro acesso
Console do navegador acusa ‘Uncaught ReferenceError: jQuery is not defined’ ou ‘is not a function’ logo após o load
Elemento volta ao normal assim que você desativa a opção ‘Delay JavaScript execution’ na aba File Optimization
Pixel de rastreamento, chat ou mapa do Google só carrega depois de mexer na página

Como prevenir

Antes de ativar o delay em produção, teste a home, uma página de venda e uma página de contato em janela anônima sem interagir, validando slider, menu e formulário.
Mantenha o Safe Mode do delay sempre ligado: ele já cobre jQuery, jQuery Migrate e scripts inline do WordPress, que são a maioria das quebras.
Use a lista de ‘One-click exclusions’ do WP Rocket para marcar plugins conhecidos de slider, formulário e analytics antes de procurar o arquivo no console.
Ao atualizar um plugin de slider ou formulário, revalide a página em janela anônima, pois o caminho do arquivo .js pode mudar e invalidar a exclusão antiga.
Prefira excluir por palavra-chave curta (como slider.min.js) em vez da URL completa, para a exclusão sobreviver a mudanças de versão do arquivo.

Causa

A opção 'Delay JavaScript execution' está ativa na aba File Optimization e nenhum script foi adicionado em 'Excluded JavaScript Files', então todo o JavaScript da página é adiado.
O script que controla o elemento depende de jQuery e roda no evento de carregamento, mas o WP Rocket adiou o jQuery, gerando 'jQuery is not defined' antes da interação.
Um plugin de slider ou formulário (por exemplo Slider Revolution, Contact Form 7, WPForms) ainda não foi marcado na lista de 'One-click exclusions' do WP Rocket para esse script.
O elemento é injetado por um script de terceiros carregado no HTML inicial (chat, pixel, Google Maps), e esse arquivo entrou no delay sem exclusão.
O Safe Mode do delay está desligado, então scripts inline registrados por wp_add_inline_script e bibliotecas como jQuery Migrate também foram adiados sem necessidade.

Como resolver

Confirme que o delay é a causa: Abra o painel do WordPress e vá até a página do WP Rocket. Entre na aba indicada abaixo, desmarque temporariamente a opção do delay e limpe o cache. Se o elemento volta a funcionar, o delay é o culpado e você pode reativá-lo no passo seguinte aplicando a exclusão correta.
```
Settings -> WP Rocket -> File Optimization
Desmarcar: Delay JavaScript execution
Salvar e limpar o cache (botão Clear cache no topo)
```
Identifique o script que quebra o elemento: Reative o delay e abra a página problemática com as Ferramentas do Desenvolvedor do navegador (tecla F12), na aba Console. Recarregue sem interagir com a página e leia o erro: ele aponta o arquivo .js que falhou. Anote o trecho do caminho do arquivo que identifica o plugin ou tema responsável, pois é ele que você vai excluir.
```
Abrir DevTools: tecla F12 -> aba Console
Erro tipico: Uncaught ReferenceError: jQuery is not defined
Anotar o caminho do arquivo, ex.: /wp-content/plugins/slider/assets/slider.min.js
```
Exclua o script na lista do WP Rocket: Volte para a aba File Optimization e localize o campo de texto 'Excluded JavaScript Files', logo abaixo da opção de delay. Cole uma palavra-chave ou trecho da URL do script identificado, uma por linha. O WP Rocket aceita URL completa ou apenas uma palavra-chave contida no caminho, o que é mais resistente a mudanças de versão do arquivo.
```
Settings -> WP Rocket -> File Optimization -> Excluded JavaScript Files
/wp-content/plugins/slider/assets/slider.min.js
slider.min.js
jquery-migrate
```
Ative o Safe Mode e salve: Ainda na mesma área, marque a opção de Safe Mode do delay. Ela exclui automaticamente jQuery, jQuery Migrate, scripts inline registrados pelo WordPress e arquivos das pastas internas, cobrindo a causa mais comum de quebra sem você precisar listar cada um. Salve, limpe o cache e recarregue a página problemática sem interagir para validar.
```
Marcar: Safe Mode for jQuery
Salvar e clicar em Clear cache
Recarregar a página sem mover o mouse para validar
```
Exclua via atributo no script (caso o campo não baste): Se o script é inserido por um snippet seu ou por um child theme e você consegue editar a tag, adicione o atributo de exclusão diretamente nela. O WP Rocket reconhece esse atributo e nunca adia a tag marcada, funcionando tanto para script externo quanto para script inline.
```
nowprocket
```

PHP

<?php
/**
 * Exclui scripts especificos do Delay JavaScript Execution do WP Rocket.
 * Coloque em um plugin de snippets ou no functions.php do child theme.
 */
add_filter( 'rocket_delay_js_exclusions', function ( $exclusions ) {
    $exclusions[] = '/wp-content/plugins/slider/assets/slider.min.js';
    $exclusions[] = 'jquery-migrate';
    $exclusions[] = 'gtag';
    return $exclusions;
} );

Perguntas frequentes

Por que o WP Rocket Delay JavaScript quebra meu site?

Porque o delay adia TODO o JavaScript da página até a primeira interação. Se um slider, menu ou formulário depende de um script que precisa rodar no carregamento, esse elemento fica inerte até o visitante mexer na página. Não é um bug: é o efeito do delay sobre um script que não suporta ser adiado, e a correção é excluir só esse script.

Como saber qual script está sendo quebrado pelo delay?

Abra a página problemática com as Ferramentas do Desenvolvedor do navegador na aba Console (tecla F12) e recarregue sem interagir. O erro, geralmente 'Uncaught ReferenceError: jQuery is not defined' ou algo do tipo, aponta o arquivo .js que falhou. O caminho do arquivo identifica o plugin ou tema que você precisa excluir do delay.

Preciso desativar o Delay JavaScript inteiro para resolver?

Não. Desativar o delay todo joga fora o ganho de performance. O correto é manter a opção ativa e excluir apenas o script que quebra, no campo 'Excluded JavaScript Files' da aba File Optimization. Assim o resto da página continua otimizado e só o elemento sensível roda imediatamente.

Qual o formato certo para excluir um script do delay no WP Rocket?

O campo 'Excluded JavaScript Files' aceita a URL completa do arquivo ou apenas uma palavra-chave contida no caminho, uma por linha. Excluir por palavra-chave curta, como slider.min.js, é mais resistente porque continua valendo mesmo se a versão do arquivo mudar na próxima atualização do plugin.

O que o Safe Mode do delay faz?

O Safe Mode exclui automaticamente jQuery, jQuery Migrate, scripts inline registrados pelo WordPress com wp_add_inline_script e arquivos das pastas internas do WordPress. Como jQuery é a dependência mais comum dos elementos que quebram, ligar o Safe Mode resolve grande parte dos casos sem você precisar listar cada arquivo manualmente.

Posso excluir um script editando a própria tag em vez da lista?

Sim. Se você consegue editar a tag do script, por estar em um snippet seu ou em um child theme, adicione o atributo nowprocket na tag. O WP Rocket reconhece esse atributo e nunca adia a tag marcada, valendo tanto para script externo quanto para script inline.

Por que o elemento volta a funcionar só depois que eu mexo na página?

Esse é o sintoma clássico do delay. O script só é liberado na primeira interação (mouse, toque, rolagem ou tecla), então o elemento que depende dele permanece congelado até esse momento. Se o seu slider, botão ou contador só anima após você mover o mouse, o delay está adiando o script dele e ele precisa entrar na lista de exclusões.

A exclusão que eu adicionei parou de funcionar depois de uma atualização. Por quê?

Provavelmente o plugin mudou o caminho ou o nome do arquivo .js na nova versão, então a URL completa que você excluiu não corresponde mais. Por isso vale excluir por palavra-chave curta em vez da URL inteira, e revalidar a página em janela anônima após cada atualização de plugins de slider, formulário ou analytics.

Grave

Como corrigir TBT alto e JavaScript bloqueante no WordPress

TBT alto no WordPress é quando o Total Blocking Time, a soma do tempo em que a thread principal fica bloqueada por JavaScript entre o primeiro render e a interatividade, passa de 200ms no laboratório. Costuma vir de scripts pesados, plugins que carregam JS no carregamento inicial e código de terceiros como rastreadores.

Grave

Como corrigir erros de integração entre WP Rocket e Cloudflare

A integração entre WP Rocket e Cloudflare falha quando as duas camadas otimizam os mesmos arquivos ou quando o add-on não autentica. O resultado é JavaScript quebrado, CSS sem aplicar ou cache que não limpa.

Atenção

Como otimizar o banco de dados WordPress para velocidade

Otimizar o banco de dados do WordPress é limpar e reorganizar as tabelas MySQL que acumulam dados desnecessários e ficam lentas com o tempo. O inchaço costuma vir de revisões de post, transients expirados, comentários de spam e tabelas órfãs deixadas por plugins removidos, que aumentam o tempo de cada query.

Atenção

Como corrigir o erro de Critical CSS não gerado no WP Rocket

O erro Critical CSS not generated no WP Rocket ocorre quando a API do plugin não consegue acessar a página para gerar o CSS crítico, retornando mensagens como Invalid response code, cURL error 28 ou Timeout. A causa quase sempre e bloqueio de IP por firewall, Cloudflare Bot Fight Mode ou WP-cron parado.

Atenção

Como corrigir a exclusão de páginas do cache no WP Rocket no WordPress

A exclusão de uma página do cache no WP Rocket não funciona quando o padrão de URL no campo Never Cache URL(s) está mal formatado, quando um cache de servidor ou CDN fica acima do plugin, ou quando o Preload recacheia a página logo após a limpeza.

Atenção

Como resolver cache que não limpa no WordPress

Cache que não limpa no WordPress é quando o site continua exibindo a versão antiga de uma página depois de você editá-la, porque alguma camada de cache não foi invalidada. Costuma vir de várias camadas empilhadas (plugin, servidor, CDN e navegador) em que purgar só uma delas deixa as outras servindo o conteúdo velho.

Setores

Extensões

Integrações

Como corrigir o Delay JavaScript do WP Rocket que quebra funções do site

O que é WP Rocket Delay JavaScript que quebra o site?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir TBT alto e JavaScript bloqueante no WordPress

Como corrigir erros de integração entre WP Rocket e Cloudflare

Como otimizar o banco de dados WordPress para velocidade

Como corrigir o erro de Critical CSS não gerado no WP Rocket

Como corrigir a exclusão de páginas do cache no WP Rocket no WordPress

Como resolver cache que não limpa no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos