Reduce unused JavaScript: carregue apenas o que cada página utiliza
O Lighthouse lista os scripts que a página descarrega e não corre durante o carregamento. O que fazem aos visitantes e como carregar cada um apenas onde é necessário.
Partilhar
Porque é que o Lighthouse diz Reduce unused JavaScript?
O Reduce unused JavaScript (Remove unused JavaScript em versões mais antigas) lista todos os scripts com mais de 20 KiB de código que não correu durante o carregamento da página, e recomenda adiar o carregamento de scripts até serem necessários. Quando esses scripts descarregam ao mesmo tempo que a foto principal, tornam-na mais lenta. Carregue cada script apenas nas páginas que o utilizam, e carregue o código de um toque apenas quando o visitante tocar.
Quer apenas a solução rápida? Salte para WordPress, Google Tag Manager e outras tags, Shopify ou Next.js e a sua própria build.
O que é que o Lighthouse considera JavaScript não utilizado?
O aviso completo diz: "Reduce unused JavaScript and defer loading scripts until they are required to decrease bytes consumed by network activity."

O Lighthouse tal como o PageSpeed Insights o executa, no site de um estúdio de ioga: o bundle do tema e o script de um plugin de mapas.
Enquanto o Lighthouse carrega a página, o Chrome regista quais as funções que correm em cada script. O código que não correu nesse carregamento conta como não utilizado, incluindo o código para ações que só acontecem quando o visitante toca ou faz scroll: o menu mobile, um seletor de datas, o carrinho. Um script é listado quando mais de 20 KiB do seu código comprimido não foram executados.
O Lighthouse agrupa os scripts por proprietário: o domínio próprio como "1st Party" e os ficheiros de terceiros sob o nome do fornecedor. Transfer Size é o tamanho do download; Est Savings é a parte que não correu. Com um source map, o Lighthouse identifica as bibliotecas dentro de um bundle nas linhas logo abaixo.
Vermelho significa que o script listado é descarregado antes de o maior elemento (LCP) ter carregado, pelo que um download mais pequeno mostraria esse elemento mais cedo. Laranja significa que o script apenas acrescenta kilobytes, tratando-se normalmente de uma tag que chega após o LCP. Unscored: o aviso em si não conta para a pontuação de Performance, mas o LCP conta, e a Google define o ranking com base no que os visitantes reais obtêm.
O que faz o JavaScript não utilizado aos visitantes?
O visitante espera mais tempo pela foto no topo da página e pelo funcionamento do slider, do menu e dos botões. O browser descarrega cada byte de um script, incluindo a parte que nunca corre, e esses bytes partilham a ligação do telemóvel com a foto e com os scripts de que a página realmente precisa.
Medi isto no site de um estúdio de ioga cujo tema de page builder carrega um slider, uma lightbox, um leitor de vídeo, um seletor de datas e animações em todas as páginas, além de um plugin de mapas que adiciona o seu próprio script. A homepage utiliza o slider e o menu; após a correção, carrega apenas o código desses elementos, e o seletor de datas apenas quando o visitante toca no botão de reserva. Ambos os testes correram numa ligação lenta de telemóvel e no processador de um telemóvel de gama média:
| Página de ioga | Download de JavaScript | Foto de LCP | Slider e menu a funcionar |
|---|---|---|---|
| Antes | 199 kB | 2,03 s | 2,07 s |
| Depois | 26 kB | 1,15 s | 1,16 s |

Antes

Depois
A página de ioga 1,5 segundos após o visitante tocar no link.
O código que nunca corre ocupa muito pouco tempo de processador, porque o browser apenas o analisa superficialmente: antes da correção, o processador precisava de cerca de 40 ms adicionais para os scripts, sendo o restante dos 0,9 segundos apenas download. De acordo com o State of Web Vitals, cerca de metade do JavaScript na homepage mediana ainda não correu no momento em que a página termina de carregar.
O código não utilizado do menu mobile deve estar na página, porque o menu tem de funcionar logo ao primeiro toque; já o script de um mapa numa página sem mapa é desperdício.
De quem é o script apontado pelo Lighthouse?
O endereço do ficheiro indica quem decide sobre ele e o que pode fazer. No WordPress, a pasta a seguir a /wp-content/plugins/ é o nome do plugin, e /wp-content/themes/ é o tema.
- O seu tema ou page builder: um bundle na pasta do tema ou os próprios ficheiros do page builder, como o
elements-handlers.min.jsdo Elementor Pro, o Lottie e o slider Swiper (WordPress). - Um plugin que traz uma biblioteca grande: com a integração de reCAPTCHA ativa, o Contact Form 7 carrega o reCAPTCHA da Google em todas as páginas, e o gateway do Stripe para o WooCommerce carrega o Stripe.js em todas as páginas de produto e de carrinho.
- Tags, listadas sob o nome da empresa: o gtag.js da Google (cerca de 150 KiB por ID de tag), o Meta Pixel, barras de cookies como a OneTrust e widgets de chat como o Intercom (tags).
- Ficheiros do Shopify e as suas apps: o Web Pixels Manager (
/cdn/wpm/…) é listado em todas as lojas Shopify e, por vir do próprio domínio da loja, parece fazer parte do tema. Apps como o Yotpo carregam a partir do domínio do criador da app (Shopify). - Os próprios chunks da sua aplicação: no Next.js ou Nuxt, chunks compostos quase só por código para mais tarde, como componentes que surgem após um toque ou um conjunto inteiro de ícones (Next.js e a sua própria build).

A página de ioga após a correção, com uma tag da Google: uma única linha laranja sob o Google Tag Manager.
Que parte de um script correu? Coverage no DevTools
O relatório apresenta um número por ficheiro; o painel Coverage no Chrome DevTools mostra que código foi executado no seu interior. Abra o DevTools, prima Ctrl+Shift+P (Cmd+Shift+P num Mac), escreva "Show Coverage" e clique no botão de recarregar do painel. Ordene por "Unused bytes": na barra, o cinzento não correu e o verde correu. Um bundle com source map desdobra-se nas suas bibliotecas, e um clique numa linha mostra o código no painel Sources.

Coverage na página de ioga antes da correção: três quartos do bundle do tema não correram e, do seletor de datas, quase nada correu.
O Coverage continua a gravar enquanto usa a página: abra o menu ou um formulário para ver que código deve carregar ao toque. Sem o DevTools, o botão View Treemap no relatório do Lighthouse e no PageSpeed Insights mostra cada script por tamanho, com os bytes não utilizados de cada um.
Como corrigir o Reduce unused JavaScript?
Comece pelo maior ficheiro que controla. O atributo defer (a opção "Load JavaScript deferred" do WP Rocket) altera o momento em que o script é executado; o ficheiro continua a ser descarregado durante o carregamento da página e permanece na lista.
WordPress
- Desative o script de um plugin onde ele não é utilizado: com o Asset CleanUp (menu "Asset CleanUp", "CSS & JS Manager") ou o Script Manager no Perfmatters, desliga um script por página, por tipo de conteúdo ou em todo o site exceto num conjunto de páginas. Ative primeiro o modo de teste para que apenas você veja as alterações. Nunca desative um ficheiro de que outros scripts precisem, como o jQuery ou o
wp-polyfill: o WordPress descarta todos os scripts dependentes e, numa loja online, isso pode ser o carrinho. - Utilize as próprias opções do page builder: no Divi, "Dynamic JavaScript Libraries" (Theme Options, General, Performance); no Slider Revolution, desative "Load JS Libraries Globally". No Elementor, cada widget Pro com JavaScript, como o Lottie ou um carrossel, acrescenta código: use menos widgets, sobretudo no cabeçalho do Theme Builder, que está presente em todas as páginas.
- Pondere o custo de um plugin face ao que ele faz: o Contact Form 7 com a integração de reCAPTCHA ativada carrega 359 KB em todas as páginas para travar algum spam num único formulário. Existem formas mais leves de manter os bots fora de um formulário: um campo oculto que apenas os bots preenchem, ou uma validação no servidor.
A opção "Delay JavaScript execution" no WP Rocket, e a mesma definição no Perfmatters, LiteSpeed Cache ou FlyingPress, elimina o aviso porque o Lighthouse nunca toca nem faz scroll no ecrã. O visitante continua a descarregar e a executar todo esse código assim que toca ou faz scroll. Uma opção de "combine JavaScript" coloca o mesmo código não utilizado num único ficheiro maior.
A funcionalidade Improved Asset Loading do Elementor, recomendada em tutoriais mais antigos, passou a estar integrada de raiz desde a versão 3.26. Volte a verificar a lista após uma atualização ou a instalação de um novo plugin: uma atualização pode mudar o nome de um script e um novo plugin pode voltar a introduzir o jQuery em todas as páginas.
Google Tag Manager e outras tags
Cada ID de tag da Google na página descarrega a sua própria cópia do gtag.js. Várias tags da Google numa única página é uma configuração a rever: um site mais lento vende menos, pelo que quem adiciona uma tag deve responsabilizar-se pelo impacto na velocidade. Pergunte quem ainda utiliza cada tag, e pause ou remova as restantes no Google Tag Manager. Uma tag com uma exceção de acionamento continua a ser descarregada com o contentor.
As tags que não geram receita podem esperar: carregue-as após o carregamento da página, ou quando o browser estiver inativo a seguir, para que a página, o carrinho e o checkout tenham prioridade. No Google Tag Manager, isso corresponde ao trigger "Window Loaded" para essas tags. No WordPress, o WP Core Web Vitals faz isto para ferramentas de analytics, píxeis e widgets de chat. Um widget de chat ou um leitor de vídeo pode esperar por um clique no respetivo botão.
Shopify
Deixe ficar a linha do Web Pixels Manager do próprio Shopify e altere as apps:
- Remova as apps que já não utiliza e desative os respetivos app embeds no editor de temas (App embeds).
- Uma app removida da loja pode deixar código para trás no tema. Pesquise pelo nome ou domínio da app em
layout/theme.liquide na pastasnippets, e remova as linhas que carregam o seu script. - Uma app de avaliações que carrega em todas as páginas mas só aparece nas páginas de produto: peça ao fornecedor para a carregar apenas aí.
Os botões de checkout acelerado (Shop Pay, Apple Pay, Google Pay) carregam os scripts de carteira digital do Shopify. Regra geral mantêm-se porque geram vendas, mas acrescentam o seu download a todas as páginas onde os botões surgem.
Next.js e a sua própria build
Separe aquilo de que o primeiro ecrã não precisa. Um componente que só surge após um toque, como um seletor de datas ou uma caixa de pesquisa, deve carregar com next/dynamic, React.lazy ou um simples import(), que o bundler transforma num ficheiro separado. Na página de ioga, o seletor de datas descarrega agora quando o visitante toca em "Book a free trial class":
document.querySelector('#book').addEventListener('click', async () => {
const { default: flatpickr } = await import('flatpickr');
flatpickr('#date', { inline: true });
}, { once: true });
A espera passa para o momento do toque: na página de ioga, o seletor de datas demorou 0,35 segundos a surgir em vez de 0,09. Inicie o download quando o botão surgir no ecrã com o scroll, ou após a página ter carregado e o browser ficar inativo, e o toque não terá nada pelo que esperar.
- Bibliotecas apenas para renderização, como syntax highlighting ou gráficos, devem estar num Server Component no App Router do Next.js: o browser recebe apenas o resultado e nada da biblioteca.
- Pacotes com múltiplos exports:
import { debounce } from 'lodash'traz cerca de 27 KB do lodash; olodash-estraz 2 KB. No caso de bibliotecas de ícones e componentes, adicione-as aexperimental.optimizePackageImportsnonext.config.js. - Descubra o que preenche um bundle com o comando
npx next analyze(Next.js 16.1 e mais recente) ou@next/bundle-analyzerpara o webpack.
Como verificar se a alteração funcionou?
Execute novamente o Lighthouse da mesma forma e abra o Coverage. Depois, toque em tudo o que separou ou cujo carregamento desativou: o menu, os formulários, o carrinho e o checkout.

O detalhe do LCP em mobile no CoreDash. O Load Time é o tempo que o browser passa a descarregar a foto de LCP.
Os scripts que partilham a ligação tornam o Load Time mais longo para os visitantes reais, pelo que deve esperar vê-lo encurtar nas páginas que alterou. O Search Console demora até 28 dias a refletir a alteração.
Quando pode deixar uma linha nesta lista?
Uma linha pode ficar quando o script compensa o respetivo download. Deixe ficar o Web Pixels Manager do Shopify, a única tag da Google que utiliza caso carregue após a página, e código acionado pelo toque, como o carrinho. Corrija o que controla quando o aviso estiver a vermelho, e qualquer ficheiro de algo que a página não tenha.
Algumas listas chegam a ter quinze ficheiros de seis fornecedores, e já ninguém sabe quais as tags e plugins que continuam em uso. Numa power hour, abrimos o seu relatório e a sua configuração de tags e decidimos que scripts ficam, e em que páginas.

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
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 URLSem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.