Guia de migração do Lighthouse v3

Este guia é para usuários do Lighthouse v2 que:

• Execute o Lighthouse no Node ou na linha de comando.
• Confie na saída JSON do Lighthouse.

Se isso não se aplicar a você, o fluxo de trabalho para executar o Lighthouse será praticamente o mesmo. Consulte Anúncio do Lighthouse 3.0 para ter uma visão geral dos novos recursos e mudanças.

Mudanças na invocação

O Lighthouse agora calcula a performance simulada por padrão, e as configurações de limitação foram bastante alteradas.

Sinalizações da CLI

Módulo de nó

No Lighthouse v3, o módulo Node aceita as mesmas opções de configuração da CLI. Esta é uma alteração interruptiva, no sentido de que muitas dessas opções foram ignoradas na v2. Agora, elas afetarão de fato a forma como o Lighthouse é executado.

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);
}

Mudanças na saída

Novo formato de nível superior na saída JSON

O objeto JSON retornado pelo Lighthouse v3 agora contém três propriedades de nível superior:

• lhr: os resultados das auditorias. Abreviação de "Resultados do Lighthouse". Esse era essencialmente o objeto de nível superior na v2, mas a v3 também introduz mudanças importantes na forma desse objeto. Consulte Mudanças no objeto de resultados.
• artifacts: Os dados coletados do Chrome durante a auditoria. Antes, isso era misturado com as propriedades do LHR.
• report: o relatório HTML/JSON/CSV formatado como uma string.

Alterações no objeto de resultados

Como mencionado em Novo formato de nível superior na saída JSON, os resultados das auditorias não estão disponíveis pela propriedade lhr. Na v2, o conteúdo desse objeto era essencialmente a saída JSON de nível superior. No entanto, a forma desse objeto mudou na v3. A tabela abaixo lista todas as mudanças.

• Se uma linha tiver um valor nas colunas v2 e v3, isso significa que você deve substituir qualquer referência à propriedade da v2 no seu código pelo equivalente da v3.
• Quando uma linha não tiver um valor na coluna v3, a coluna Observações descreverá as opções.
• Itens como ID representam marcadores de posição de texto.