Руководство по миграции Lighthouse v3

Это руководство предназначено для пользователей Lighthouse v2, которые:

• Запустите Lighthouse из Node или из командной строки.
• Положитесь на выходные данные Lighthouse в формате JSON.

Если это к вам не относится, то ваш рабочий процесс при запуске Lighthouse в основном такой же. См. «Анонс Lighthouse 3.0» для обзора новых функций и изменений.

Изменения вызова

Lighthouse теперь по умолчанию рассчитывает смоделированную производительность, а настройки регулирования были сильно изменены.

Флаги CLI

Узловой модуль

В Lighthouse v3 модуль Node принимает те же параметры конфигурации, что и CLI. Это кардинальное изменение в том смысле, что многие из этих опций были проигнорированы в версии 2, тогда как теперь они действительно будут влиять на работу 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);
}

Изменения вывода

Новый формат верхнего уровня в выводе JSON.

Объект JSON, возвращаемый Lighthouse v3, теперь содержит три свойства верхнего уровня:

• lhr . Результаты проверок. Сокращение от «Результаты маяка». По сути, это был объект верхнего уровня в версии 2, но в версии 3 также внесены серьезные изменения в форму этого объекта. См. Изменения в объекте результатов .
• artifacts . Данные, собранные из Chrome во время аудита. Ранее это было смешано со свойствами LHR.
• report . Отчет в формате HTML/JSON/CSV в виде строки.

Изменения в объекте результатов

Как упоминалось в разделе «Новый формат верхнего уровня в выводе JSON» , результаты аудита недоступны через свойство lhr . В версии 2 содержимое этого объекта по существу представляло собой вывод JSON верхнего уровня. Однако форма самого этого объекта изменилась в версии 3. В таблице ниже перечислены все изменения.

• Если строка имеет значение как в столбцах v2 , так и в v3 , это означает, что вам следует заменить любую ссылку на свойство v2 в вашем коде эквивалентом v3.
• Если строка не имеет значения в столбце v3 , столбец «Примечания» описывает ваши варианты.
• Обратите внимание, что такие элементы, как ID представляют собой текст-заполнитель.