{"canonical_url":"https://engineer.company/uk/glossary/lighthouse/","content_markdown":"# Lighthouse\n\n## Що це таке\n\nLighthouse, яку часто називають Google Lighthouse, — програма з відкритим кодом від команди Chrome,\nяка завантажує одну вебсторінку в контрольованих умовах, записує, що робив браузер, і оцінює\nрезультат від 0 до 100 у чотирьох категоріях: продуктивність, доступність, найкращі практики й SEO.\nВона працює на будь-якій сторінці, до якої може дістатися, публічній чи закритій входом, а кожна\nперевірка у звіті посилається на короткий документ про те, навіщо ця перевірка існує і як її пройти.\n\nТой самий рушій працює в чотирьох місцях:\n\n- у Chrome DevTools, з панелі Lighthouse;\n- у командному рядку, як `lighthouse \u003curl\u003e` після глобального встановлення через npm;\n- як модуль Node у власному скрипті;\n- за PageSpeed Insights, сервісом Google, який запускає її на машинах Google.\n\nОцінка продуктивності складається лише з метрик, виміряних під час завантаження: First Contentful\nPaint, Speed Index, Largest Contentful Paint, Total Blocking Time і Cumulative Layout Shift. Кожну\nметрику розміщують на кривій, побудованій за даними реальних сайтів з HTTP Archive, а оцінка\nкатегорії — це зважене середнє цих п'яти. У Lighthouse 10 вага Total Blocking Time становить 30%,\nLargest Contentful Paint і Cumulative Layout Shift — по 25%, а двох інших — по 10%. Ваги змінювалися\nміж версіями, бо команда постійно досліджує, що найбільше впливає на те, наскільки швидкою здається\nсторінка.\n\nКрива має дві опорні точки. Значення метрики на рівні 25-го процентиля архіву дає 50 балів, а на\nрівні 8-го — 90. Для всіх п'яти метрик менше означає краще, тож сторінка з 50 балами за однією з них\nуже випереджає три чверті виміряних сайтів; 50 — це не середній результат. Угорі крива вирівнюється:\nщоб піднятися з 99 до 100, потрібно приблизно стільки ж покращення, скільки для переходу з 90 до 94.\n\nТри інші категорії натомість оцінюються за аудитами. У доступності кожен аудит або пройдено, або ні,\nбез балів за часткове проходження; вагу кожного визначає оцінка рушія правил axe щодо того,\nнаскільки сильно збій б'є по користувачах, а перевірки, яким потрібна людина, не входять до оцінки й\nвиносяться в окремий список для ручного перегляду.\n\n## Чому це важливо\n\nРішення, якому служить Lighthouse, стосується того, чи зміна зробила сторінку повільнішою, менш\nзручною чи важчою для пошуку і чи має це зупинити випуск. Відповідь приходить у формі, з якою може\nпрацювати машина: число, ті самі аудити щоразу й звіт, який може прочитати скрипт. Тому її досить\nдешево запускати на кожній зміні, а не раз перед запуском продукту.\n\nЧисло — це лабораторне вимірювання: один профіль пристрою, одна імітована мережа, одне завантаження.\nPageSpeed Insights показує різницю, ставлячи поруч два види даних. Лабораторна частина — це прогін\nLighthouse. Польова частина походить із Chrome UX Report: те, що реальні користувачі Chrome отримали\nза попередні 28 днів, на рівні 75-го процентиля, щоб число описувало більшість відвідувачів, а не\nнайщасливіших. Для сторінки, у якої замало власних відвідувань, показують дані всього її походження\n(origin). Документація попереджає, що ці дві частини можуть розходитися.\n\nВід цього поділу залежить, для чого придатна кожна з них. Польові дані кажуть, чи є в користувачів\nпроблема, але надходять через тижні після зміни й нічого не кажуть про гілку, яку ще не випущено.\nЛабораторні дані можна зібрати до випуску й так часто, як треба, і саме тому вони годяться як\nзапобіжник, але описують лише один імітований візит.\n\nДруга межа — шум. Посібник з оцінювання пропонує сприймати продуктивність як розподіл оцінок, а не\nодне число, і перелічує причини поза самою сторінкою: A/B-тести й змінну рекламу, зміни\nмаршрутизації в інтернеті, потужний настільний комп'ютер проти слабкого ноутбука, розширення\nбраузера й антивіруси. Поріг, перевірений на одному прогоні, падатиме випадково. Посібник проєкту\nпро варіативність дає цьому рішенню число: медіана п'яти прогонів удвічі стабільніша за один прогін.\n\nLighthouse CI перетворює це на правило. Він запускає Lighthouse кілька разів для кожної адреси, за\nзамовчуванням тричі, поєднує прогони й перевіряє результат за твердженнями (assertions) для цілої\nкатегорії або одного аудиту. Твердження рівня `warn` лише повідомляє, а рівня `error` валить збірку.\nПорогом слугує мінімальна оцінка, максимальне значення метрики або максимальна кількість знайдених\nелементів:\n\n```json\n{\n    \"ci\": {\n        \"collect\": { \"numberOfRuns\": 5 },\n        \"assert\": {\n            \"assertions\": {\n                \"categories:accessibility\": [\"error\", { \"minScore\": 1 }],\n                \"largest-contentful-paint\": [\n                    \"error\",\n                    { \"maxNumericValue\": 2500, \"aggregationMethod\": \"median\" }\n                ]\n            }\n        }\n    }\n}\n```\n\n## Як це виглядає на практиці\n\n[Сторінка подяк](/uk/credits/) цього сайту називає Lighthouse серед інструментів, які сайт запускає\nпроти себе на тій самій машині, де його пишуть, і дає йому одне завдання: стежити за бюджетами\nпродуктивності. Бюджет — це межа, погоджена заздалегідь, щоб сторінка, яка стала повільнішою,\nпровалювала перевірку, а не відкривала суперечку про те, чи важать кілька сотень мілісекунд.\n\nПізніший розділ тієї ж сторінки посилається на PageSpeed Insights серед перевірок, які читач може\nзапустити сам, і каже, що цей сервіс запускає Lighthouse з машин Google, а не з машин сайту, а там,\nде відвідувачів достатньо, додає дані реальних користувачів. Сторінка навмисно тримає ці два розділи\nокремо. Перший — це сайт, що сам собі виставляє оцінки; другий віддає ті самі питання інструментам,\nякі сайтові не належать і не вірять йому на слово.\n\nЗвичку, через яку бюджет варто тримати, видно й у роботі тут, що не має стосунку до жодних оцінок.\nРозповідь про те, як\n[пакунок стилів скоротили з 87 КБ до 31](/uk/portfolio/cut-the-stylesheet-bundle-from-87-kb-to-31-kb/),\nпочинає опис дій словами «Спершу — вимірювання». Дві третини найбільшої таблиці стилів виявилися\nодним шрифтом, закодованим у base64; третій варіант насиченості шрифту додали до попереднього\nзавантаження лише тоді, коли дані реального використання показали, що саме він завершує найдовший\nкритичний ланцюжок; а сучасний формат зображень для фірмового знака виміряли й відхилили, бо файл\nвийшов більшим. За кожним рішенням там стоїть вимірювання, зокрема й за тим, що закінчилося\nвідмовою. Підказкам Lighthouse потрібне те саме ставлення: кожна з них — гіпотеза, доки вимірювання\nне покаже, що вона допомогла.\n\n## Де виникають проблеми\n\nБільшість помилок із Lighthouse походить від того, що число читають як щось більше, ніж воно є.\n\n**Один прогін сприймають як істину.** Один звіт показує 94, наступний — 87, і хтось шукає регресію,\nякої не було. Порівнюйте медіани кількох прогонів і свідомо обирайте спосіб агрегації в Lighthouse\nCI: твердження без параметрів бере з усіх прогонів значення, яке найімовірніше пройде, тож регресія\nпрослизне, якщо її уникне хоча б один прогін.\n\n**Прогони збирають паралельно.** Коли десять адрес перевіряють одночасно на одній машині, вони\nзмагаються за процесор, пам'ять і мережу, і посібник про варіативність прямо радить цього не робити.\nЗапускайте їх по черзі або на кількох машинах; для Lighthouse кілька малих машин кращі за одну\nвелику.\n\n**Лабораторну оцінку сприймають як досвід відвідувачів.** 98 на ноутбуці розробниці каже, що\nсторінка може бути швидкою; лише польові дані кажуть, чи була вона такою. Дивіться польову частину в\nPageSpeed Insights і зважайте, що для сторінки з малою кількістю відвідувань там будуть дані всього\nїї походження (origin).\n\n**Підказки плутають з оцінкою.** Opportunities і Diagnostics не входять до оцінки продуктивності;\nвони впливають на неї лише через метрики, які покращують. Оберіть підказку, що має зрушити важливу\nдля цієї сторінки метрику, внесіть зміну й виміряйте знову.\n\n**Ідеальна оцінка стає метою.** Посібник з оцінювання називає 100 надзвичайно складним результатом і\nкаже, що його не очікують. Коли сторінка вже в зеленій зоні, останні бали коштують більше, ніж\nдають.\n\n**Повну оцінку доступності сприймають як доступну сторінку.** 100 там означає, що пройшли\nавтоматичні аудити. Ручні перевірки стоять поряд з оцінкою й ніколи не враховуються, тож сторінка\nможе мати 100 і все одно бути непридатною для роботи з клавіатури.\n\n## Що почитати далі\n\n- [Introduction to Lighthouse](https://developer.chrome.com/docs/lighthouse/overview) — способи\n  запуску, категорії звіту й де лежить документація до кожного аудиту.\n- [Lighthouse performance scoring](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring)\n  — ваги метрик за версіями, криві оцінювання й кольорові зони.\n- [Lighthouse accessibility score](https://developer.chrome.com/docs/lighthouse/accessibility/scoring)\n  — як зважують аудити і чому ручні перевірки не входять до оцінки.\n- [Score Variability](https://github.com/GoogleChrome/lighthouse/blob/main/docs/variability.md) —\n  джерела шуму, що зменшує кожне з них, і чому варто запускати кілька разів.\n- [About PageSpeed Insights](https://developers.google.com/speed/docs/insights/v5/about) —\n  лабораторні й польові дані, 75-й процентиль і оцінка Core Web Vitals.\n- [Lighthouse CI configuration](https://github.com/GoogleChrome/lighthouse-ci/blob/main/docs/configuration.md)\n  — кілька прогонів, написання тверджень і вибір способу поєднання прогонів.\n\n\u003chttps://engineer.company/uk/glossary/lighthouse/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як Lighthouse перетворює одне завантаження сторінки на чотири оцінки, чому один прогін — це вибірка, а не вирок, і як тримають бюджет продуктивності.","formats":{"gemtext":"https://engineer.company/uk/glossary/lighthouse/index.gmi","gopher":"https://engineer.company/uk/glossary/lighthouse/gophermap","html":"https://engineer.company/uk/glossary/lighthouse/","json":"https://engineer.company/uk/glossary/lighthouse/index.json","markdown":"https://engineer.company/uk/glossary/lighthouse/index.md","pdf":"https://engineer.company/uk/glossary/lighthouse/index.pdf"},"kind":"page","language":"uk","title":"Що таке Lighthouse?","url":"https://engineer.company/uk/glossary/lighthouse/","version":1}