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.

Arjen Karel
Aggiornato il · 7 min di lettura
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".

Lighthouse report, Legacy JavaScript in red with Est savings of 22 KiB and the labels FCP, LCP and Unscored; the script booking.legacy.js with 22.0 KiB wasted bytes and under it 18 lines such as @babel/plugin-transform-classes, Array.from and Object.entries

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:

BuildModulo di prenotazione a schermoJavaScript (gzip)Esecuzione dello script
Per Internet Explorer 111,93 s83 kB80 ms
Per i browser attuali1,73 s49 kB50 ms
Phone screen 1.8 seconds after the tap with the Internet Explorer 11 build: the ferry page's heading, no photo yet and a grey placeholder where the booking form goes

Prima

The same moment with the build for current browsers: the car deck photo and the booking form with route, date and passengers

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 elenca frontend-gtag.min.js di 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.at e Object.hasOwn.
Lighthouse report, Legacy JavaScript in red with Est savings of 22 KiB and the labels FCP, LCP and Unscored; the script booking.legacy.js with 22.0 KiB wasted bytes and under it 18 lines such as @babel/plugin-transform-classes, Array.from and Object.entries

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 disattivare wp-polyfill direttamente 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.

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

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
Arjen Karel
Arjen Karel, Consulente web performance dal 2009

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 URL

Non hai uno sviluppatore per il fix? Faccio io il lavoro, su una copia del tuo sito.

Arjen KarelCore Web Vitals in rosso su mobile?Mandami il tuo URL