Установка на устройство

Lighthouse — это автоматизированный инструмент для улучшения качества веб-страниц, который анализирует производительность, доступность, лучшие практики и SEO. Для полноценной работы с Lighthouse на локальном устройстве требуется корректная установка и настройка окружения.

Установка через npm

Наиболее распространённый способ установки Lighthouse — через пакетный менеджер npm. Для этого необходимо, чтобы на устройстве был установлен Node.js версии 14 и выше. Проверку версии Node.js выполняют командой:

node -v

После подтверждения корректной версии Node.js выполняется глобальная установка Lighthouse:

npm install -g lighthouse

Ключевые моменты при глобальной установке:

  • Глобальный флаг -g позволяет запускать Lighthouse из любой директории системы.
  • После установки доступна команда lighthouse в терминале.

Для проверки корректности установки достаточно выполнить:

lighthouse --version

Если терминал выводит номер версии, установка прошла успешно.

Локальная установка в проект

Иногда требуется интеграция Lighthouse непосредственно в проект. Для этого выполняют локальную установку:

npm install --save-dev lighthouse

Особенности локальной установки:

  • Пакет доступен только внутри проекта.
  • Обеспечивает возможность использовать Lighthouse в скриптах сборки, например через npm scripts.
  • Позволяет фиксировать версию инструмента для всех участников команды.

Пример использования в package.json:

{
  "scripts": {
    "audit": "lighthouse https://example.com --output html --output-path ./report.html"
  }
}

Запуск анализа выполняется командой:

npm run audit

Установка через Chrome DevTools

Lighthouse интегрирован в Google Chrome, поэтому отдельная установка может быть не обязательна, если используется браузер. Для этого:

  1. Открыть DevTools (F12 или Ctrl+Shift+I / Cmd+Option+I на macOS).
  2. Перейти на вкладку Lighthouse.
  3. Выбрать категории анализа и нажать Generate report.

Особенности:

  • Быстрый способ проведения аудита без установки Node.js.
  • Ограничен возможностями локального запуска скриптов и автоматизации.

Использование Docker

Для работы с Lighthouse в изолированном окружении можно использовать Docker. Этот способ удобен для CI/CD и тестирования без установки Node.js на систему:

docker pull justinribeiro/lighthouse
docker run --rm -it justinribeiro/lighthouse https://example.com

Преимущества:

  • Не требуется настройка локальной среды.
  • Гарантированно одинаковая версия Lighthouse на разных устройствах.
  • Упрощает интеграцию в автоматизированные пайплайны.

Настройка PATH и окружения

После глобальной установки важно убедиться, что PATH настроен корректно, чтобы терминал видел команду lighthouse. Для этого на Linux и macOS добавляют путь к глобальным пакетам npm:

export PATH=$PATH:$(npm bin -g)

На Windows следует проверить, что путь к папке с глобальными пакетами npm добавлен в переменную окружения Path.

Обновление Lighthouse

Lighthouse активно развивается. Для обновления глобальной версии выполняют:

npm update -g lighthouse

Локальные версии обновляются через:

npm update --save-dev lighthouse

Важно регулярно обновлять инструмент, чтобы получать актуальные метрики и исправления ошибок.

Проверка работоспособности

После установки рекомендуется выполнить тестовый запуск:

lighthouse https://example.com --output json --output-path ./report.json

Это создаст отчёт в формате JSON, который можно анализировать или использовать в автоматизированных скриптах.

Оглавление