Guía de migración de Lighthouse v3

Esta guía está dirigida a los usuarios de Lighthouse v2 que cumplen con los siguientes requisitos:

• Ejecuta Lighthouse desde Node o la línea de comandos.
• Usa el resultado JSON de Lighthouse.

Si no se aplican a tu caso, tu flujo de trabajo para ejecutar Lighthouse es, en su mayoría, el mismo. Consulta Anuncio de Lighthouse 3.0 para obtener una descripción general de las funciones y los cambios nuevos.

Cambios en la invocación

Lighthouse ahora calcula el rendimiento simulado de forma predeterminada, y la configuración de limitación cambió mucho.

Marcas de la CLI

Situación	Marcas de v2	Marcas de v3
Limitación de 3G de DevTools	Ninguna (comportamiento predeterminado)	--throttling-method=devtools
Sin limitación	--disable-network-throttling --disable-cpu-throttling	--throttling-method=provided
Limitación de la red, sin limitación de la CPU	--disable-cpu-throttling	--throttling-method=devtools --throttling.cpuSlowdownMultiplier=1
Ejecuta auditorías de rendimiento	--perf	--preset=perf
Ejecuta auditorías de contenido mixto	--mixed-content	--preset=mixed-content

Módulo de nodo

En Lighthouse v3, el módulo Node acepta las mismas opciones de configuración que la CLI. Este es un cambio drástico en el sentido de que muchas de estas opciones se ignoraron en la versión 2, mientras que ahora afectarán el modo en que se ejecuta Lighthouse.

const fs = require('fs');
const lighthouse = require('lighthouse');
async function run() {
  // `onlyCategories` was previously only available as a config setting.
  // `output` was previously only available in CLI.
  const flags = {onlyCategories: ['performance'], output: 'html'};
  const html = (await lighthouse('https://google.com/', flags)).report;
  fs.writeFileSync('report.html', html);
}

Cambios en la salida

Nuevo formato de nivel superior en el resultado JSON

El objeto JSON que muestra Lighthouse v3 ahora contiene tres propiedades de nivel superior:

• lhr. Los resultados de las auditorías. Es la sigla en inglés de "Resultados de Lighthouse". Este era, en esencia, el objeto de nivel superior en la v2, pero la v3 también presenta cambios drásticos en la forma de este objeto. Consulta Cambios en el objeto de resultados.
• artifacts: Los datos recopilados de Chrome durante la auditoría. Anteriormente, se mezclaba con las propiedades de la LHR.
• report: El informe con formato HTML/JSON/CSV como una cadena.

Cambios en el objeto de resultados

Como se menciona en Nuevo formato de nivel superior en el resultado JSON, los resultados de las auditorías ya no están disponibles a través de la propiedad lhr. En la versión 2, el contenido de este objeto era, en esencia, el resultado JSON de nivel superior. Sin embargo, la forma de este objeto cambió en la v3. En la siguiente tabla, se enumeran todos los cambios.

• Si una fila tiene un valor en las columnas v2 y v3, significa que debes reemplazar cualquier referencia a la propiedad v2 en tu código por el equivalente de v3.
• Cuando una fila no tiene un valor en la columna v3, la columna Notas describe tus opciones.
• Ten en cuenta que elementos como ID representan texto de marcador de posición.

Propiedad de v2	v3-Equivalent	Notas
initialUrl	requestedUrl
url	finalUrl
generatedTime	fetchedTime
reportCategories	categories	Se cambió de array a un objeto con clave.
reportGroups	categoryGroups
audits.ID.name	audits.ID.id
audits.ID.description	audits.ID.title
audits.ID.helpText	audits.ID.description
audits.ID.scoringMode	audits.ID.scoreDisplayMode	Los valores posibles se expandieron a numeric|binary|manual|informative|not-applicable|error.
audits.ID.score	audits.ID.score	Las puntuaciones siempre son un número entre 0 y 1 (no de 0 a 100) cuando scoreDisplayMode es numérico o binario. Las puntuaciones siempre son null para otros modos de visualización, ya que no hay una noción de aprobado o reprobado.
audits.ID.displayValue	audits.ID.displayValue	Ahora puede ser un array de argumentos de estilo printf para la interpolación de cadenas.
audits.ID.debugString	audits.ID.explanation audits.ID.errorMessage audits.ID.warnings	Los valores de debugString se convirtieron en una de las tres propiedades anteriores según su intención.
audits.ID.details	audits.ID.details	La estructura de los detalles cambió para que sea más fácil de usar. Cada entrada de .items es un objeto con claves confiables en lugar de any[].
audits.ID.error	audits.ID.scoreDisplayMode === 'error'
audits.ID.notApplicable	audits.ID.scoreDisplayMode === 'not-applicable'
audits.ID.informative	audits.ID.scoreDisplayMode === 'informative'
audits.ID.manual	audits.ID.scoreDisplayMode === 'manual'
audits.ID.extendedInfo		Se quitó el elemento. Usa details en su lugar.