Legacy JavaScript in Lighthouse: cosa correggere, cosa lasciare stare
Codice per vecchi browser che ogni visitatore scarica. Di chi è il file segnalato da Lighthouse e cosa fare su WordPress, Shopify, Next.js e sulla tua build.
Condividi
Ha senso correggere Legacy JavaScript?
Lighthouse mostra Legacy JavaScript ("I polyfill e le trasformazioni consentono ai browser meno recenti di usare le nuove funzionalità JavaScript") al posto del vecchio Avoid serving legacy JavaScript to modern browsers. Elenca gli script con codice per browser che quasi nessuno usa più, e ogni visitatore lo scarica. Correggi il tuo JavaScript compilandolo per i browser Baseline Widely available; per i file di un plugin o di un vendor, aggiorna, sostituisci o lascia stare.
Vuoi subito la soluzione rapida? Salta a WordPress, Shopify, Next.js o alla tua build.
Cosa trova Legacy JavaScript negli script?
L'avviso recita: "I polyfill e le trasformazioni consentono ai browser meno recenti di usare le nuove funzionalità JavaScript. Tuttavia, molte non sono necessarie per i browser moderni. Valuta di modificare il processo di build di JavaScript in modo da non transpilare le funzionalità Baseline, a meno che tu non debba supportare per forza browser meno recenti".

Il widget di prenotazione di una pagina di test per traghetti, analizzato con le impostazioni usate da PageSpeed Insights: un solo script da 22 KiB.
Lighthouse raggruppa gli script per dominio ("1st Party" per il tuo codice, il nome dell'azienda per un vendor) e assegna a ciascuno i suoi "Wasted bytes". Sotto ogni script, una riga che prende il nome da una funzionalità, come Array.prototype.find o Object.entries, è un polyfill: codice che aggiunge quella funzionalità ai browser che non la supportano. Una riga che inizia con @babel/plugin-transform è una trasformazione: Babel, lo strumento che ha generato il file, ha riscritto codice moderno, come una classe o una funzione async, in JavaScript più vecchio con funzioni helper.
I kilobyte sono una stima e possono superare la dimensione del file stesso. Un piccolo fallback per una singola funzionalità viene conteggiato come se lo script contenesse il codice di base condiviso di core-js, la libreria di polyfill più comune, perciò un file che scarica 4 KiB può mostrarne 10 KiB.
Il colore rosso indica che uno script in elenco viene scaricato contemporaneamente all'elemento più grande (LCP) o al primo contenuto (FCP); l'arancione indica che aggiunge soltanto kilobyte. Unscored: Legacy JavaScript in sé non incide sul punteggio di Performance, ma LCP e FCP sì.
Che impatto ha il legacy JavaScript sui visitatori?
Il visitatore aspetta un po' di più per qualsiasi elemento generato dallo script: un modulo di prenotazione, un menu, uno slider. Il browser scarica il codice in più e lo esegue, anche quando supporta già ogni funzionalità nativamente: ciascun polyfill verifica la propria funzionalità e mantiene la versione nativa del browser, ma i byte e il controllo si ripetono a ogni caricamento di pagina.
Su una pagina di test, la home page di una compagnia di traghetti per auto, ho compilato il widget di prenotazione in React due volte a partire dallo stesso codice: una per Internet Explorer 11 con Babel e core-js, una per i browser attuali. Entrambi hanno girato sulla stessa connessione mobile, un round trip di 150 ms a 1,6 Mbps, con la CPU di uno smartphone di fascia media:
| Build | Modulo di prenotazione a schermo | JavaScript (gzip) | Esecuzione dello script |
|---|---|---|---|
| Per Internet Explorer 11 | 1,93 s | 83 kB | 80 ms |
| Per i browser attuali | 1,73 s | 49 kB | 50 ms |

Prima

Dopo
La pagina del traghetto 1,8 secondi dopo il tap del visitatore sul link.
Sono 0,2 secondi per un solo script, di cui 30 ms di esecuzione. Uno script differito condivide comunque la connessione con la foto in cima alla pagina, ed è per questo che qui l'avviso è diventato rosso. Un bundle con tutto core-js, o una pagina con più bundle di questo tipo, ha molto più codice extra rispetto a questo widget.
Di chi è il file segnalato da Lighthouse?
L'indirizzo del file nel report indica chi lo ha compilato, e questo determina cosa puoi fare:
- Il tuo bundle: un tema o un'app compilata dal tuo sviluppatore. Modifichi un'impostazione di build e ricompili (La tua build).
- Lo script di un plugin: su WordPress, la cartella dopo
/wp-content/plugins/nell'indirizzo indica il plugin. Lighthouse elencafrontend-gtag.min.jsdi MonsterInsights, il gateway Stripe per WooCommerce nelle pagine prodotto e di checkout, e i date picker nei plugin di moduli (flatpickr in WPForms, Ninja Forms ed Elementor).wp-polyfill.min.jsè un file di WordPress caricato quando un plugin lo richiede: i blocchi di WooCommerce o Contact Form 7 con reCAPTCHA attivo (WordPress). - Il tag di un vendor, elencato sotto il nome dell'azienda: Meta Pixel (
fbevents.js), il banner dei cookie di OneTrust, gli script di moduli e feedback di HubSpot e il beacon di Cloudflare Web Analytics, che Cloudflare aggiunge direttamente alle pagine. Google Tag Manager e gtag.js non sono in elenco. Solo il vendor può ricompilare questi file: o tieni il tag o lo rimuovi. Cloudflare Web Analytics si disattiva dalla dashboard di Cloudflare. - Next.js: qualsiasi sito Next.js ha in elenco uno script con i polyfill interni di Next.js, con righe come
Array.prototype.ateObject.hasOwn.

La pagina del traghetto con la build per i browser attuali e l'aggiunta di Meta Pixel: rimane solo il file di Facebook.
Come correggere Legacy JavaScript?
Inizia dal file più grande sotto il tuo controllo, poi passa al plugin o all'app che carica codice vecchio su ogni pagina.
WordPress
Aggiorna prima WordPress e il plugin: una nuova versione potrebbe già essere compilata per i browser attuali. Poi, per ogni file in elenco:
- Un plugin che non ti serve su ogni pagina: il date picker di un plugin per moduli o lo script di un gateway di pagamento devono stare solo sulle pagine che li usano. Disattivali altrove con Asset CleanUp (menu "Asset CleanUp", "CSS & JS Manager") o con lo Script Manager di Perfmatters.
- Un plugin con un'alternativa: se un plugin di analytics come MonsterInsights carica il proprio script su ogni pagina, passa a uno che aggiunge solo il tag ufficiale di Google, come Site Kit by Google.
wp-polyfill: il plugin Query Monitor elenca gli script che ne dipendono. Trova il plugin responsabile e caricalo solo dove viene usato, come il reCAPTCHA di Contact Form 7 sulla pagina dei contatti. Non disattivarewp-polyfilldirettamente con questi strumenti e non deregistrarlo nel codice: WordPress scarterebbe silenziosamente ogni script che ne ha bisogno, e su uno store WooCommerce questo include il mini-cart, il carrello e il checkout.
"Delay JavaScript execution" in WP Rocket fa sparire l'avviso, ma il visitatore scarica ed esegue comunque lo stesso codice, al primo tap o scroll.
Shopify
I file in elenco provengono da un'app, da un tag incollato nel tema o dagli script di un tema su misura. Aggiorna l'app o chiedi al vendor una build recente, rimuovi le app che non usi più e indirizza lo sviluppatore del tema su misura all'impostazione di build.
Next.js
Per impostazione predefinita, Next.js compila il tuo codice per i browser attuali, oppure secondo la browserslist definita in package.json. Nessuna impostazione rimuove i polyfill aggiunti da Next.js stesso. Lascia quella riga.
La tua build
Indica alla build quali browser supportare e smetti di aggiungere polyfill. Baseline Widely available è l'insieme di funzionalità supportate da tutti i principali browser da almeno 30 mesi. A livello globale, solo lo 0,2% circa dei visitatori usa un browser che non supporta classi o funzioni async; prima di fare il passaggio, controlla nei tuoi dati di analytics se ci sono vecchi iPhone fermi a iOS 15 o 16. In package.json:
"browserslist": [
"baseline widely available"
]
Serve browserslist 4.26 o superiore. Con Babel 7, rimuovi useBuiltIns, corejs e targets da @babel/preset-env, oltre alla riga import "core-js/stable" se presente nell'entry file:
// babel.config.js
module.exports = {
presets: ['@babel/preset-env']
};
Senza targets, Babel legge la browserslist in package.json: riscrive solo la sintassi non supportata da quei browser e non aggiunge alcun polyfill. Babel 8 ha rimosso useBuiltIns e corejs, e Vite, esbuild e webpack non aggiungono polyfill di per sé: in una build con webpack provengono da babel-loader, quindi la modifica su Babel copre tutto. Inoltre, per impostazione predefinita anche Vite compila per Baseline Widely available.
Se dopo la ricompilazione rimane ancora qualche riga, proviene da un pacchetto in node_modules con una build obsoleta: aggiorna o sostituisci quel pacchetto.
Poi esegui di nuovo Lighthouse, nello stesso modo di prima: leggerai "No legacy JavaScript found", oppure vedrai elencati solo i file che non compili tu.
Uno script che la pagina non usa affatto riguarda un altro avviso: Reduce unused JavaScript.
Quando puoi lasciare Legacy JavaScript nel report?
Lascialo stare quando le righe in elenco sono i polyfill interni di Next.js, o quando il file è il tag di un vendor necessario che non puoi sostituire, a patto che l'avviso sia arancione. Intervieni invece se il file è un tuo bundle di decine di KiB o se l'avviso è rosso: in quel caso il file viene scaricato insieme all'elemento LCP, e un file più leggero fa arrivare quell'elemento prima. Il tag di un vendor che non puoi ridurre può invece essere avviato dopo il caricamento dell'elemento LCP: modi per caricare uno script più tardi.
Un sito con dieci tag di vendor e venti plugin deve farsi una domanda diversa: quali di quegli script servono davvero a ciascuna pagina. In una power hour apriamo il report delle tue pagine e stabiliamo quali script tenere, e su quali pagine.

Ti serve un sito più veloce?
Sono Arjen e da 17 anni sistemo siti lenti. Se hai problemi che non riesci a risolvere da solo, mandami il tuo URL e ne parliamo.
Mandami il tuo URL
Perché il fix non funziona?
A volte la CDN serve ancora il vecchio HTML, oppure il fix è finito nel template desktop e il mobile ne usa un altro. Mandami il tuo URL e il problema, e ti rispondo con qualche orario. Prima analizzo i tuoi field data, poi dedichiamo un'ora al tuo sito, ed entro un giorno hai le mie note per iscritto. 350 € IVA esclusa.
Mandami il tuo URLNon hai uno sviluppatore per il fix? Faccio io il lavoro, su una copia del tuo sito.