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.
• Confía en el resultado JSON de Lighthouse.

Si estos no se aplican a tu caso, entonces tu flujo de trabajo para ejecutar Lighthouse es casi el mismo. Consulta Anuncio de Lighthouse 3.0 para ver una descripción general de las nuevas funciones y los cambios.

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 CLI

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 funcionamiento de 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 de 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". En esencia, este era el objeto de nivel superior de la v2, pero la v3 también presenta cambios rotundos 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 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 los elementos como ID representan el texto del marcador de posición.