Legacy JavaScript no Lighthouse: o que corrigir, o que manter
Código para browsers antigos que todos os visitantes descarregam. De quem é o ficheiro apontado pelo Lighthouse e o que fazer no WordPress, Shopify, Next.js e na sua própria build.
Partilhar
Deve corrigir o Legacy JavaScript?
O Lighthouse mostra Legacy JavaScript ("Polyfills and transforms enable older browsers to use new JavaScript features") onde antes mostrava Avoid serving legacy JavaScript to modern browsers. Lista scripts que incluem código para browsers que quase ninguém usa, e todos os visitantes descarregam-no. Corrija o seu próprio JavaScript gerando a build para browsers Baseline Widely available; atualize, substitua ou mantenha o ficheiro de um plugin ou fornecedor.
Quer apenas a solução rápida? Salte para WordPress, Shopify, Next.js ou a sua própria build.
O que encontra o Legacy JavaScript nos seus scripts?
O aviso diz: "Polyfills and transforms enable older browsers to use new JavaScript features. However, many aren’t necessary for modern browsers. Consider modifying your JavaScript build process to not transpile Baseline features, unless you know you must support older browsers."

O widget de reservas de uma página de teste de ferries, executado com as definições que o PageSpeed Insights utiliza: um script com 22 KiB.
O Lighthouse agrupa os scripts por domínio ("1st Party" para os seus próprios, o nome da empresa para um fornecedor) e atribui a cada um os respetivos "Wasted bytes". Sob cada script, uma linha com o nome de uma funcionalidade, como Array.prototype.find ou Object.entries, é um polyfill: código que adiciona essa funcionalidade a browsers que não a têm. Uma linha que começa por @babel/plugin-transform é uma transform: o Babel, a ferramenta que gerou o ficheiro, reescreveu código moderno, como uma classe ou uma função async, em JavaScript mais antigo com funções auxiliares.
Os kilobytes são uma estimativa e podem ser superiores ao tamanho do próprio ficheiro. Um pequeno fallback para uma única funcionalidade é contabilizado como se o script trouxesse o código base partilhado da core-js, a biblioteca habitual de polyfills, pelo que um ficheiro que descarrega 4 KiB pode apresentar 10 KiB.
Vermelho significa que um script listado é descarregado ao mesmo tempo que o seu maior elemento (LCP) ou o seu primeiro conteúdo (FCP); laranja significa que apenas acrescenta kilobytes. Unscored: o Legacy JavaScript em si não conta para a pontuação de Performance, mas o LCP e o FCP contam.
O que faz o legacy JavaScript aos visitantes?
O visitante espera um pouco mais por aquilo que o script constrói: um formulário de reservas, um menu, um slider. O browser descarrega o código extra e executa-o, mesmo quando já dispõe de todas as funcionalidades: cada polyfill faz a verificação e mantém a versão do próprio browser, mas os bytes e a verificação surgem em cada carregamento de página.
Numa página de teste, a homepage de uma empresa de ferries para automóveis, criei o widget de reservas em React duas vezes a partir do mesmo código: uma para o Internet Explorer 11 com Babel e core-js, outra para browsers atuais. Ambas correram na mesma ligação de telemóvel, com um round trip de 150 ms a 1,6 Mbps, no CPU de um telemóvel de gama média:
| Build | Formulário de reservas no ecrã | JavaScript (gzip) | Execução do script |
|---|---|---|---|
| Para o Internet Explorer 11 | 1,93 s | 83 kB | 80 ms |
| Para browsers atuais | 1,73 s | 49 kB | 50 ms |

Antes

Depois
A página do ferry 1,8 segundos após o visitante tocar no link.
São 0,2 segundos para um único script, 30 ms dos quais em execução. Um script diferido continua a partilhar a ligação com a fotografia no topo da página, razão pela qual o aviso ficou vermelho aqui. Um bundle com toda a core-js, ou uma página com vários bundles deste tipo, tem ainda mais código extra do que este widget.
De quem é o ficheiro apontado pelo Lighthouse?
O endereço do ficheiro no relatório revela quem o gerou, e isso determina o que pode fazer:
- O seu próprio bundle: um tema ou aplicação que o seu programador cria. Altera uma definição de build e volta a gerar a build (A sua própria build).
- O script de um plugin: no WordPress, a pasta a seguir a
/wp-content/plugins/no endereço identifica o plugin. O Lighthouse lista ofrontend-gtag.min.jsdo MonsterInsights, o gateway do Stripe para o WooCommerce em páginas de produto e de checkout, e seletores de data em plugins de formulários (flatpickr no WPForms, Ninja Forms e Elementor). Owp-polyfill.min.jsé um ficheiro do WordPress que carrega quando um plugin o solicita: os blocos do WooCommerce ou o Contact Form 7 com o reCAPTCHA ativado (WordPress). - Uma tag de fornecedor, listada com o nome da empresa: o Meta Pixel (
fbevents.js), a barra de cookies da OneTrust, os scripts de formulários e feedback da HubSpot e o beacon do Cloudflare Web Analytics, que a própria Cloudflare adiciona às páginas. O Google Tag Manager e o gtag.js não são listados. Apenas o fornecedor pode reconstruir estes ficheiros: mantenha a tag ou remova-a. Desativa o Cloudflare Web Analytics no painel da Cloudflare. - Next.js: todos os sites Next.js têm um script listado com os polyfills do próprio Next.js, com linhas como
Array.prototype.ateObject.hasOwn.

A página do ferry com a build para browsers atuais e o Meta Pixel adicionado: resta apenas o ficheiro do Facebook.
Como corrigir o Legacy JavaScript?
Comece pelo maior ficheiro que controla e, depois, pelo plugin ou aplicação que carrega código antigo em todas as páginas.
WordPress
Atualize primeiro o WordPress e o plugin: uma nova versão pode já ter sido compilada para browsers atuais. Depois, para cada ficheiro listado:
- Um plugin que não é necessário em todas as páginas: o seletor de datas de um formulário ou o script de um gateway de pagamento só devem carregar nas páginas que os utilizam. Impeça o seu carregamento em todas as outras com o Asset CleanUp (menu "Asset CleanUp", "CSS & JS Manager") ou com o Script Manager no Perfmatters.
- Um plugin com alternativas: se um plugin de analytics como o MonsterInsights carregar o seu próprio script listado em todas as páginas, mude para um que apenas adicione a tag oficial da Google, como o Site Kit by Google.
wp-polyfill: o plugin Query Monitor lista os scripts que dependem dele. Identifique o plugin na sua origem e carregue esse plugin apenas onde ele é necessário, como o reCAPTCHA do Contact Form 7 na página de contacto. Não impeça o carregamento dowp-polyfillnessas ferramentas nem faça deregister no código: o WordPress simplesmente descarta todos os scripts que dependem dele e, numa loja WooCommerce, isso inclui o mini-carrinho, o carrinho e o checkout.
A opção "Delay JavaScript execution" no WP Rocket elimina o aviso, mas o visitante continua a descarregar e a executar o mesmo código, logo no primeiro toque ou scroll.
Shopify
Um ficheiro listado provém de uma app, de uma tag colada no tema ou dos scripts de um tema personalizado. Atualize a app ou peça ao fornecedor uma build atualizada, remova as apps que já não utiliza e encaminhe o programador de um tema personalizado para a definição de build.
Next.js
Por predefinição, o Next.js compila o seu código para browsers atuais e para a browserslist no package.json, se tiver uma configurada. Nenhuma definição remove os polyfills que o próprio Next.js adiciona. Deixe ficar essa linha.
A sua própria build
Indique à sua build quais os browsers com que deve ser compatível e deixe de adicionar polyfills. O Baseline Widely available é o conjunto de funcionalidades com que todos os principais browsers são compatíveis há pelo menos 30 meses. A nível mundial, cerca de 0,2% dos visitantes usam um browser que não consegue executar classes ou funções async; antes de fazer a mudança, verifique nos seus dados de analytics se tem iPhones antigos retidos no iOS 15 ou 16. No package.json:
"browserslist": [
"baseline widely available"
]
Isto requer o browserslist 4.26 ou mais recente. No Babel 7, remova useBuiltIns, corejs e targets de @babel/preset-env, bem como a linha import "core-js/stable" se o seu ficheiro de entrada a tiver:
// babel.config.js
module.exports = {
presets: ['@babel/preset-env']
};
Sem targets, o Babel lê a browserslist no package.json: passa a reescrever apenas a sintaxe que falta a esses browsers e não adiciona polyfills. O Babel 8 removeu useBuiltIns e corejs, e o Vite, o esbuild e o webpack não adicionam polyfills por si próprios: numa build com webpack eles vêm do babel-loader, pelo que a alteração no Babel resolve o problema. O Vite também compila para Baseline Widely available por predefinição.
Uma linha que se mantenha após a nova build provém de um pacote em node_modules com a sua própria build antiga: atualize ou substitua esse pacote.
Depois, execute novamente o Lighthouse, da mesma forma que antes: indicará "No legacy JavaScript found", ou listará apenas ficheiros cuja build não é sua.
Um script que a página não utilize de todo corresponde a um aviso diferente: Reduce unused JavaScript.
Quando pode deixar o Legacy JavaScript no relatório?
Deixe-o ficar quando as linhas listadas forem os polyfills do próprio Next.js, ou quando o ficheiro for uma tag de terceiros necessária e insubstituível, desde que o aviso esteja a laranja. Corrija-o quando o ficheiro for o seu próprio bundle com dezenas de KiB, ou quando o aviso estiver a vermelho: nesse caso, o ficheiro é descarregado em simultâneo com o elemento de LCP, e um ficheiro mais pequeno permite que esse elemento surja mais depressa. Uma tag de terceiros que não consiga reduzir pode, em alternativa, ser carregada depois de o elemento de LCP aparecer: formas de carregar um script mais tarde.
Um site com dez tags de terceiros e vinte plugins enfrenta uma questão diferente: quais desses scripts são realmente necessários em cada página. Numa power hour, abrimos o relatório das suas próprias páginas e definimos que scripts listados 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.