Legacy JavaScript en Lighthouse: qué corregir y qué dejar

Código para navegadores antiguos que todos los visitantes descargan. De quién es el archivo que señala Lighthouse y qué hacer en WordPress, Shopify, Next.js y tu propio build.

Arjen Karel
Actualizado el · 7 min de lectura
Compartir

¿Deberías corregir Legacy JavaScript?

Lighthouse muestra Legacy JavaScript ("Los polyfills y las transformaciones permiten a los navegadores más antiguos usar nuevas funciones de JavaScript") donde antes mostraba Avoid serving legacy JavaScript to modern browsers. Enumera scripts con código para navegadores que casi nadie usa, y todos los visitantes lo descargan. Corrige tu propio JavaScript compilándolo para navegadores Baseline Widely available; si el archivo es de un plugin o proveedor, actualízalo, sustitúyelo o déjalo.

¿Solo buscas la solución rápida? Ve directo a WordPress, Shopify, Next.js o tu propio build.

¿Qué encuentra Legacy JavaScript en los scripts?

El aviso dice: "Los polyfills y las transformaciones permiten a los navegadores más antiguos usar nuevas funciones de JavaScript. Sin embargo, muchas no son necesarias para los navegadores modernos. Considera modificar el proceso de compilación de JavaScript para no transpilar funciones de Baseline, a menos que sepas que debes admitir navegadores más antiguos".

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

El widget de reservas de una página de prueba de ferris, analizado con la configuración que usa PageSpeed Insights: un script con 22 KiB.

Lighthouse agrupa los scripts por dominio ("1st Party" para los propios, el nombre de la empresa para un proveedor) y asigna a cada uno sus "Wasted bytes". Debajo de cada script, una línea con el nombre de una característica, como Array.prototype.find o Object.entries, es un polyfill: código que añade esa característica a los navegadores que no la tienen. Una línea que empieza por @babel/plugin-transform es una transformación: Babel, la herramienta que generó el archivo, reescribió código moderno, como una clase o una función async, en JavaScript antiguo con funciones auxiliares.

Los kilobytes son una estimación y pueden ser mayores que el propio archivo. Un pequeño fallback para una sola característica se cuenta como si el script incluyera el código base compartido de core-js, la librería habitual de polyfills, por lo que un archivo que descarga 4 KiB puede mostrar 10 KiB.

El rojo significa que un script de la lista se descarga al mismo tiempo que el elemento más grande (LCP) o el primer contenido (FCP); el naranja significa que solo añade kilobytes. Unscored: Legacy JavaScript en sí no cuenta para la puntuación de Performance, pero el LCP y el FCP sí.

¿Qué efecto tiene el JavaScript legacy en los visitantes?

El visitante espera un poco más por lo que construye el script: un formulario de reserva, un menú, un slider. El navegador descarga el código adicional y lo ejecuta, incluso cuando ya incluye todas las características de forma nativa: cada polyfill comprueba su característica y conserva la versión del propio navegador, pero los bytes y la comprobación se repiten en cada carga de página.

En una página de prueba, la portada de una compañía de ferris de coches, compilé el widget de reservas en React dos veces a partir del mismo código: una para Internet Explorer 11 con Babel y core-js, y otra para navegadores actuales. Ambas pruebas se ejecutaron sobre la misma conexión móvil, un round trip de 150 ms a 1,6 Mbps, con la CPU de un móvil de gama media:

BuildFormulario de reserva en pantallaJavaScript (gzip)Ejecución del script
Para Internet Explorer 111,93 s83 kB80 ms
Para navegadores actuales1,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

Antes

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

After

La página del ferry 1,8 segundos después de que el visitante tocara el enlace.

Eso supone 0,2 segundos para un solo script, 30 ms de ellos de ejecución. Un script diferido sigue compartiendo la conexión con la foto de la parte superior de la página, por lo que el aviso se puso en rojo aquí. Un bundle con todo core-js, o una página con varios bundles como este, acumula más código extra que este widget.

¿De quién es el archivo que señala Lighthouse?

La dirección del archivo en el informe indica quién lo compiló, y eso determina lo que puedes hacer:

  • Tu propio bundle: un tema o una app que compila tu desarrollador. Cambias un ajuste del build y vuelves a compilar (Tu propio build).
  • El script de un plugin: en WordPress, la carpeta tras /wp-content/plugins/ en la dirección corresponde al plugin. Lighthouse enumera frontend-gtag.min.js, de MonsterInsights, la pasarela de Stripe para WooCommerce en páginas de producto y checkout, y selectores de fecha en plugins de formularios (flatpickr en WPForms, Ninja Forms y Elementor). wp-polyfill.min.js es un archivo de WordPress que se carga cuando un plugin lo solicita: los bloques de WooCommerce o Contact Form 7 con reCAPTCHA activado (WordPress).
  • El tag de un proveedor, que aparece bajo el nombre de la empresa: Meta Pixel (fbevents.js), el banner de cookies de OneTrust, los scripts de formularios y feedback de HubSpot, y el beacon de Cloudflare Web Analytics, que la propia Cloudflare añade a las páginas. Google Tag Manager y gtag.js no aparecen en la lista. Solo el proveedor puede recompilar estos archivos: o mantienes el tag o lo eliminas. Cloudflare Web Analytics se desactiva desde el panel de Cloudflare.
  • Next.js: todos los sitios con Next.js tienen un script en la lista con los polyfills propios de Next.js, con líneas como Array.prototype.at y Object.hasOwn.
Lighthouse report, Legacy JavaScript in orange with Est savings of 11 KiB: only Facebook's fbevents.js from connect.facebook.net with 10.9 KiB and eight lines, the three Babel transforms and Array.from, filter, find, map and String.prototype.startsWith

La página del ferry con el build para navegadores actuales y el Meta Pixel añadido: solo queda el archivo de Facebook.

¿Cómo corriges Legacy JavaScript?

Empieza por el archivo más grande que controles y sigue con el plugin o la app que cargue código antiguo en todas las páginas.

WordPress

Actualiza primero WordPress y el plugin: una versión más reciente ya puede estar compilada para navegadores actuales. Luego, para cada archivo de la lista:

  • Un plugin que no necesitas en todas las páginas: el selector de fecha de un plugin de formularios o el script de una pasarela de pago corresponden solo a las páginas que los usan. Descárgalos en las demás con Asset CleanUp (menú "Asset CleanUp", "CSS & JS Manager") o con el Script Manager de Perfmatters.
  • Un plugin con alternativa: si un plugin de analítica como MonsterInsights carga su propio script en todas las páginas, cambia a uno que solo añada la etiqueta propia de Google, como Site Kit by Google.
  • wp-polyfill: el plugin Query Monitor muestra los scripts que dependen de él. Localiza el plugin responsable y cárgalo solo donde se use, como el reCAPTCHA de Contact Form 7 en la página de contacto. No descargues wp-polyfill en esas herramientas ni lo desregistres por código: WordPress descartará silenciosamente todos los scripts que lo necesiten, y en una tienda WooCommerce eso incluye el minicarrito, el carrito y el checkout.

"Delay JavaScript execution" en WP Rocket elimina el aviso, pero el visitante sigue descargando y ejecutando el mismo código con el primer tap o scroll.

Shopify

Un archivo de la lista proviene de una app, de una etiqueta pegada en el tema o de los scripts propios de un tema a medida. Actualiza la app o pide al proveedor un build actual, elimina las apps que ya no uses y remite a quien desarrolle el tema a medida a el ajuste del build.

Next.js

Next.js compila tu propio código para navegadores actuales por defecto, y según la browserslist de package.json si la has definido. Ningún ajuste elimina los polyfills que añade la propia Next.js. Deja esa línea.

Tu propio build

Indica a tu build con qué navegadores ser compatible y deja de añadir polyfills. Baseline Widely available es el conjunto de características que todos los navegadores principales admiten desde hace al menos 30 meses. A nivel mundial, alrededor del 0,2 % de los visitantes usa un navegador que no puede ejecutar clases ni funciones async; revisa tu propia analítica por si quedan iPhones antiguos anclados en iOS 15 o 16 antes de cambiar. En package.json:

"browserslist": [
  "baseline widely available"
]

Esto requiere browserslist 4.26 o posterior. En Babel 7, elimina useBuiltIns, corejs y targets de @babel/preset-env, además de la línea import "core-js/stable" si aparece en tu archivo de entrada:

// babel.config.js
module.exports = {
  presets: ['@babel/preset-env']
};

Sin targets, Babel lee la browserslist en package.json: de este modo solo reescribe la sintaxis que falte en esos navegadores y no añade ningún polyfill. Babel 8 eliminó useBuiltIns y corejs, y herramientas como Vite, esbuild y webpack no añaden polyfills por su cuenta: en un build con webpack provienen de babel-loader, por lo que el cambio en Babel lo cubre. Además, Vite compila para Baseline Widely available por defecto.

Si queda alguna línea tras recompilar, proviene de un paquete en node_modules con su propio build antiguo: actualiza o sustituye ese paquete.

Luego vuelve a ejecutar Lighthouse, del mismo modo que antes: mostrará "No legacy JavaScript found" o listará únicamente los archivos que no compilas tú.

Un script que la página no usa en absoluto corresponde a un aviso diferente: Reduce unused JavaScript.

¿Cuándo puedes dejar Legacy JavaScript en el informe?

Déjalo cuando las líneas de la lista sean los polyfills propios de Next.js, o cuando el archivo sea el tag de un proveedor que necesitas y no puedes sustituir, siempre que el aviso sea naranja. Corrígelo cuando el archivo sea tu propio bundle con decenas de KiB, o cuando el aviso esté en rojo: en ese caso, el archivo se descarga al mismo tiempo que el elemento LCP, y un archivo más pequeño permite que ese elemento llegue antes. El tag de un proveedor que no puedas reducir puede iniciarse después de que haya cargado el elemento LCP: formas de cargar un script más tarde.

Un sitio con diez tags de proveedores y veinte plugins plantea una duda distinta: qué scripts necesita realmente cada página. En una power hour abrimos el informe de tus páginas y resolvemos qué scripts de la lista se quedan y en qué 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

¿Necesitas una web más rápida?

Soy Arjen y llevo 17 años arreglando webs lentas. Si te encuentras con problemas que no puedes resolver por tu cuenta, envíame tu URL y hablamos.

Envíame tu URL
Arjen Karel
Arjen Karel, Consultor de rendimiento web desde 2009

¿Por qué no funciona nuestro fix?

A veces la CDN sigue sirviendo el HTML antiguo, o el fix se metió en la plantilla de desktop y el móvil usa otra. Envíame tu URL y el problema, y te respondo con varias opciones. Primero reviso tus field data, luego dedicamos una hora a tu web, y en menos de un día tienes mis notas por escrito. 350 € sin IVA.

Envíame tu URL

¿No tienes desarrollador para hacer el fix? Hago el trabajo yo mismo, en una copia de tu web.

Arjen Karel¿Core Web Vitals todavía en rojo en móvil?Envíame tu URL