Guía de migración de Lighthouse v3

Esta guía está destinada a los usuarios de Lighthouse v2 que:

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

Si estos no se aplican a tu caso, el flujo de trabajo para ejecutar Lighthouse es prácticamente el mismo. Consulta el anuncio de Lighthouse 3.0 para obtener una descripción general de las nuevas funciones y los cambios.

Cambios en las invocaciones

Lighthouse ahora calcula el rendimiento simulado de forma predeterminada, y se realizaron muchos cambios en la configuración de regulación.

Marcas de la 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 rotundo en el sentido de que muchas de estas opciones se ignoraron en la v2, mientras que ahora afectarán la forma 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 los resultados

Nuevo formato de nivel superior en resultados JSON

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

• lhr. Los resultados de las auditorías. Es la abreviatura de "Resultados de Lighthouse". En esencia, este era el objeto de nivel superior en 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, esto 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 mencionó en Nuevo formato de nivel superior para resultados de JSON, los resultados de las auditorías no están disponibles a través de la propiedad lhr. En la v2, el contenido de este objeto eran, básicamente, el resultado de JSON de nivel superior. Sin embargo, la forma de este objeto cambió en la versión 3. La siguiente tabla incluye 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 Notes describe tus opciones.
• Ten en cuenta que los elementos como ID representan texto del marcador de posición.