Legacy JavaScript no Lighthouse: o que corrigir e o que deixar
Código para navegadores antigos que todo visitante baixa. De quem é o arquivo apontado pelo Lighthouse e o que fazer no WordPress, Shopify, Next.js e no seu próprio build.
Compartilhar
Você deve corrigir o Legacy JavaScript?
O Lighthouse mostra Legacy JavaScript ("Polyfills e transforms permitem que navegadores mais antigos usem novos recursos do JavaScript") onde antes mostrava Avoid serving legacy JavaScript to modern browsers. Ele lista scripts com código para navegadores que quase ninguém usa, e todo visitante baixa esse conteúdo. Corrija seu próprio JavaScript gerando o build para navegadores Baseline Widely available; para arquivos de plugins ou de fornecedores, atualize, substitua ou deixe como está.
Quer apenas a solução rápida? Pule para WordPress, Shopify, Next.js ou seu próprio build.
O que o Legacy JavaScript encontra nos scripts?
O aviso diz: "Polyfills e transforms permitem que navegadores mais antigos usem novos recursos do JavaScript. No entanto, muitos não são necessários para navegadores modernos. Considere modificar o processo de build do JavaScript para não transpilar recursos do Baseline, a menos que você precise de compatibilidade com navegadores mais antigos."

O widget de reservas em uma página de teste de balsa, executada com as configurações do PageSpeed Insights: um script com 22 KiB.
O Lighthouse agrupa os scripts por domínio ("1st Party" para os seus próprios e o nome da empresa para fornecedores externos) e exibe os "Wasted bytes" de cada um. Abaixo de cada script, uma linha com o nome de um recurso, como Array.prototype.find ou Object.entries, indica um polyfill: código que adiciona esse recurso a navegadores que não o possuem nativamente. Uma linha iniciada por @babel/plugin-transform indica um transform: o Babel, ferramenta que gerou o arquivo, reescreveu código moderno, como uma classe ou função async, em JavaScript antigo usando funções auxiliares.
Os kilobytes são uma estimativa e podem ser maiores do que o próprio arquivo. Um fallback pequeno para um único recurso é contabilizado como se o script carregasse todo o código base compartilhado do core-js, a biblioteca padrão de polyfills. Por isso, um arquivo que baixa 4 KiB pode acusar 10 KiB.
Vermelho significa que o script listado é baixado ao mesmo tempo que o maior elemento da tela (LCP) ou o primeiro conteúdo (FCP); laranja significa que ele apenas adiciona 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 o JavaScript legado faz com os visitantes?
O visitante espera um pouco mais por tudo o que o script monta: um formulário de reserva, um menu, um slider. O navegador baixa o código extra e o executa, mesmo quando já tem todos os recursos nativos: cada polyfill verifica o recurso e mantém a versão do próprio navegador, mas os bytes extras e a checagem acontecem a cada carregamento de página.
Em uma página de teste — a página inicial de uma empresa de balsas —, gerei o build do widget de reserva em React duas vezes a partir do mesmo código: uma para o Internet Explorer 11 com Babel e core-js, e outra para navegadores atuais. Ambos rodaram na mesma conexão de celular, com latência de 150 ms a 1,6 Mbps, na CPU de um celular intermediário:
| Build | Formulário na tela | JavaScript (gzip) | Execução do script |
|---|---|---|---|
| Para Internet Explorer 11 | 1,93 s | 83 kB | 80 ms |
| Para navegadores atuais | 1,73 s | 49 kB | 50 ms |

Antes

Depois
A página da balsa 1,8 segundo após o visitante tocar no link.
Isso representa 0,2 segundo para um único script, sendo 30 ms de execução. Mesmo com defer, o script ainda divide a conexão com a foto no topo da página — por isso o aviso ficou vermelho aqui. Um bundle com todo o core-js, ou uma página com vários bundles desse tipo, carrega muito mais código desnecessário do que este widget.
De quem é o arquivo apontado pelo Lighthouse?
O endereço do arquivo no relatório indica quem gerou o código, e isso define o que você pode fazer:
- Seu próprio bundle: um tema ou app desenvolvido pela sua equipe. Você altera uma configuração de build e recompila (Seu próprio build).
- Script de um plugin: no WordPress, a pasta após
/wp-content/plugins/no endereço identifica o plugin. O Lighthouse lista ofrontend-gtag.min.jsdo MonsterInsights, o gateway do Stripe para WooCommerce nas páginas de produto e checkout, e seletores de data em plugins de formulário (flatpickr no WPForms, Ninja Forms e Elementor). Owp-polyfill.min.jsé um arquivo do WordPress carregado quando algum plugin solicita: blocos do WooCommerce ou Contact Form 7 com reCAPTCHA ativado (WordPress). - Tag de um fornecedor, listada sob o nome da empresa: Meta Pixel (
fbevents.js), banner de cookies da OneTrust, scripts de formulário e feedback da HubSpot, e o beacon do Cloudflare Web Analytics, que a própria Cloudflare injeta nas páginas. Google Tag Manager e gtag.js não são listados. Apenas o fornecedor pode recompilar esses arquivos: mantenha a tag ou remova. Você desativa o Cloudflare Web Analytics diretamente no painel da Cloudflare. - Next.js: todo site em Next.js tem um script listado com os polyfills do próprio Next.js, com linhas como
Array.prototype.ateObject.hasOwn.

A página da balsa com o build para navegadores atuais e o Meta Pixel adicionado: sobrou apenas o arquivo do Facebook.
Como corrigir o Legacy JavaScript?
Comece pelo maior arquivo sob seu controle e, depois, passe para o plugin ou app que carrega código antigo em todas as páginas.
WordPress
Atualize o WordPress e o plugin primeiro: uma nova versão pode ter sido compilada para navegadores atuais. Depois, para cada arquivo listado:
- Um plugin desnecessário em todas as páginas: o seletor de data de um plugin de formulário ou o script de um gateway de pagamento só deve carregar nas páginas onde é usado. Desative o carregamento no restante do site com o Asset CleanUp (menu "Asset CleanUp", "CSS & JS Manager") ou com o Script Manager do Perfmatters.
- Um plugin com alternativa: se um plugin de analytics como o MonsterInsights carrega um script próprio apontado no relatório em todas as páginas, troque por um que adicione apenas a tag nativa do Google, como o Site Kit by Google.
wp-polyfill: o plugin Query Monitor lista os scripts que dependem dele. Identifique o plugin por trás deles e carregue esse plugin apenas onde for usado — como o reCAPTCHA do Contact Form 7 só na página de contato. Não desative owp-polyfillnessas ferramentas nem faça deregister no código: o WordPress simplesmente descarta sem aviso todos os scripts que precisam dele — em uma loja WooCommerce, isso inclui o minicarrinho, o carrinho e o checkout.
O "Delay JavaScript execution" do WP Rocket elimina o aviso, mas o visitante continua baixando e executando exatamente o mesmo código no primeiro toque ou rolagem.
Shopify
Um arquivo listado vem de um app, de uma tag colada no tema ou dos scripts do próprio tema personalizado. Atualize o app ou peça ao fornecedor um build atual, remova os apps que não usa mais e envie para quem desenvolveu o tema personalizado a configuração de build.
Next.js
O Next.js gera o build do seu código para navegadores atuais por padrão, ou para o browserslist no package.json se você tiver definido um. Nenhuma configuração remove os polyfills inseridos pelo próprio Next.js. Deixe essa linha como está.
Seu próprio build
Indique no build quais navegadores atender e pare de adicionar polyfills. Baseline Widely available é o conjunto de recursos compatíveis com todos os principais navegadores há pelo menos 30 meses. No mundo todo, cerca de 0,2% dos visitantes usam um navegador que não consegue rodar classes ou funções async; confira no seu analytics se há iPhones antigos presos ao iOS 15 ou 16 antes de mudar. No package.json:
"browserslist": [
"baseline widely available"
]
Isso exige o browserslist 4.26 ou superior. Com o Babel 7, remova useBuiltIns, corejs e targets de @babel/preset-env, além da linha import "core-js/stable" se o arquivo de entrada contiver essa importação:
// babel.config.js
module.exports = {
presets: ['@babel/preset-env']
};
Sem targets, o Babel lê o browserslist no package.json: assim, ele só reescreve a sintaxe que esses navegadores não possuem e não adiciona polyfills. O Babel 8 removeu useBuiltIns e corejs, e Vite, esbuild e webpack não adicionam polyfills por conta própria: no webpack, eles vêm do babel-loader, então a alteração no Babel resolve. O Vite também já compila para Baseline Widely available por padrão.
Se alguma linha continuar aparecendo após o rebuild, ela vem de algum pacote em node_modules com build antigo próprio: atualize ou substitua esse pacote.
Depois, execute o Lighthouse de novo, da mesma forma que antes: ele exibirá "No legacy JavaScript found" ou listará apenas arquivos fora do seu controle de build.
Um script que a página nem sequer usa entra em outro aviso: Reduce unused JavaScript.
Quando deixar o Legacy JavaScript no relatório?
Deixe como está se as linhas listadas forem polyfills do próprio Next.js ou se o arquivo for uma tag de fornecedor necessária e insubstituível — desde que o aviso esteja em laranja. Corrija quando o arquivo for um bundle próprio com dezenas de KiB ou quando o aviso estiver em vermelho: nesse caso, o arquivo baixa junto com o elemento do LCP, e um arquivo menor faz esse elemento carregar mais rápido. Se você não puder reduzir o tamanho da tag de um fornecedor, adie o início dela para depois que o elemento do LCP já tiver carregado: veja formas de adiar o carregamento de scripts.
Para um site com dez tags de terceiros e vinte plugins, a questão é outra: quais desses scripts cada página realmente precisa. Em uma power hour, abrimos o relatório das suas páginas e definimos quais scripts listados devem ficar e em quais páginas.

Precisa de um site mais rápido?
Sou o Arjen e há 17 anos conserto sites lentos. Se você está com problemas que não consegue resolver sozinho, me envie sua URL e vamos conversar.
Me envie sua URL
Por que nosso fix não está funcionando?
Às vezes a CDN ainda entrega o HTML antigo, ou o fix entrou no template de desktop e o celular usa outro. Me envie sua URL e o problema, e eu respondo com alguns horários. Primeiro analiso o field data, depois dedicamos uma hora ao seu site, e em até um dia você tem minhas anotações por escrito. €350 sem IVA.
Me envie sua URLSem desenvolvedor para fazer o fix? Eu mesmo faço o trabalho, em uma cópia do seu site.