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.

Arjen Karel
Atualizado a · 10 min de leitura
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."

Lighthouse report, Reduce unused JavaScript in red with Est savings of 151 KiB and the labels FCP, LCP and Unscored; under acme-yoga.test with the label 1st Party the theme's theme.min.js with 116.1 KiB est savings and five library lines under it (plyr, glightbox, flatpickr, swiper, gsap ScrollTrigger), and a map plugin's leaflet.js with 34.7 KiB

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 iogaDownload de JavaScriptFoto de LCPSlider e menu a funcionar
Antes199 kB2,03 s2,07 s
Depois26 kB1,15 s1,16 s
Phone screen 1.5 seconds after the tap, before the fix: the yoga studio's heading and booking button on a plain dark background, no photo yet

Antes

The same moment after the fix: the photo of a yoga class behind the heading and the booking button

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.js do 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).
Lighthouse report, Reduce unused JavaScript in orange with Est savings of 99 KiB: only gtag.js from www.googletagmanager.com, listed under Google Tag Manager, 154.1 KiB transfer size and 99.0 KiB est savings

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.

Chrome DevTools Coverage panel, per function: the theme's theme.min.js with 493,999 total bytes and 373,557 unused bytes (75.6%), opened into its libraries: plyr 91.2% unused, glightbox 88%, flatpickr 98.7%, gsap ScrollTrigger 83.5%, swiper-core 43.5%

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.liquid e na pasta snippets, 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; o lodash-es traz 2 KB. No caso de bibliotecas de ícones e componentes, adicione-as a experimental.optimizePackageImports no next.config.js.
  • Descubra o que preenche um bundle com o comando npx next analyze (Next.js 16.1 e mais recente) ou @next/bundle-analyzer para 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.

CoreDash, LCP subparts for images on mobile at p75: a donut and four phases, Time To First Byte, Load Delay, Load Time in purple with the label Improve, and Render Delay

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.

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 KarelCore Web Vitals a vermelho em mobile?Envie-me o seu URL