# Lighthouse

## Ce que c'est

Lighthouse, souvent appelé Google Lighthouse, est un programme open source de l'équipe Chrome qui charge une page web dans des conditions contrôlées, enregistre ce que le navigateur fait et note le résultat sur 100 dans quatre catégories : performance, accessibilité, bonnes pratiques et SEO. Il fonctionne sur toute page accessible, publique ou soumise à authentification, et chaque contrôle de son rapport renvoie à un court document qui explique son but et comment le réussir.

Le même moteur fonctionne à quatre endroits :

- dans Chrome DevTools, depuis le panneau Lighthouse ;
- en ligne de commande, avec `lighthouse <url>` après une installation npm globale ;
- comme module Node, dans votre propre script ;
- derrière PageSpeed Insights, service de Google qui l'exécute sur ses machines.

La note de performance vient uniquement des métriques mesurées pendant le chargement : First Contentful Paint, Speed Index, Largest Contentful Paint, Total Blocking Time et Cumulative Layout Shift. Chaque métrique est placée sur une courbe issue de sites réels recensés dans HTTP Archive, et la note de la catégorie est une moyenne pondérée des cinq. Dans Lighthouse 10, les poids sont de 30 % pour Total Blocking Time, de 25 % chacun pour Largest Contentful Paint et Cumulative Layout Shift, et de 10 % chacun pour les deux autres. Ils ont changé entre les versions, car l'équipe continue d'étudier ce qui influence le plus la vitesse ressentie d'une page.

La courbe possède deux points fixes. Une valeur au 25e percentile de l'archive obtient 50, et une valeur au 8e percentile obtient 90. Pour chacune de ces métriques, plus la valeur est basse, mieux c'est : une page notée 50 sur l'une d'elles dépasse donc déjà les trois quarts des sites mesurés ; 50 n'est pas la moyenne. Vers le sommet, la courbe s'aplatit : passer de 99 à 100 demande environ autant de progrès que passer de 90 à 94.

Les trois autres catégories sont notées à partir d'audits. En accessibilité, chaque audit réussit ou échoue, sans points pour une réussite partielle ; chacun est pondéré selon l'évaluation, par le moteur de règles axe, de la gravité d'un échec pour les utilisateurs. Les contrôles nécessitant une personne sont exclus de la note et listés pour examen manuel.

## Pourquoi c'est important

Lighthouse aide à décider si une modification a rendu une page plus lente, plus difficile à utiliser ou à trouver, et si cela doit en empêcher la livraison. Sa réponse est exploitable par une machine : un nombre, les mêmes audits à chaque exécution et un rapport qu'un script peut analyser. Le coût reste ainsi assez faible pour l'exécuter à chaque modification plutôt qu'une seule fois avant le lancement.

Le nombre est une mesure de laboratoire : un profil d'appareil, un réseau simulé, un chargement. PageSpeed Insights montre la différence en juxtaposant deux types de données. Sa section de laboratoire est une exécution de Lighthouse. Sa section de terrain vient du Chrome UX Report : l'expérience de véritables utilisateurs de Chrome sur les 28 jours précédents, présentée au 75e percentile pour décrire la plupart des visiteurs plutôt que les plus chanceux. Lorsqu'une page reçoit trop peu de visites pour disposer de ses propres données, les chiffres de l'ensemble de son origine sont affichés. La documentation dit de s'attendre à des différences entre les deux sections.

Cette distinction détermine leur usage. Les données de terrain indiquent si les utilisateurs rencontrent un problème, mais arrivent des semaines après une modification et ne disent rien d'une branche non livrée. Les données de laboratoire peuvent être recueillies avant publication et aussi souvent que nécessaire : elles servent donc de garde-fou, mais décrivent une seule visite simulée.

L'autre limite est le bruit. Le guide de notation conseille de lire la performance « comme une distribution de notes plutôt qu'un nombre unique » et cite des causes extérieures à la page : tests A/B et publicités diffusées en rotation, changements de routage Internet, ordinateur de bureau rapide face à un portable lent, extensions du navigateur et antivirus. Un seuil vérifié sur une seule exécution échouera aléatoirement. Le guide de variabilité chiffre le remède : la médiane de cinq exécutions est deux fois plus stable qu'une exécution unique.

Lighthouse CI transforme cela en règle. Il exécute Lighthouse plusieurs fois par adresse, trois si aucun autre nombre n'est configuré, combine les exécutions et confronte le résultat à des assertions sur une catégorie entière ou un audit. Une assertion `warn` ne fait que signaler ; une assertion `error` fait échouer la construction. Son seuil est une note minimale, une valeur maximale pour une métrique ou un nombre maximal d'éléments en défaut :

```json
{
    "ci": {
        "collect": { "numberOfRuns": 5 },
        "assert": {
            "assertions": {
                "categories:accessibility": ["error", { "minScore": 1 }],
                "largest-contentful-paint": [
                    "error",
                    { "maxNumericValue": 2500, "aggregationMethod": "median" }
                ]
            }
        }
    }
}
```

## À quoi cela ressemble en pratique

La [page des crédits de ce site](/fr/credits/) cite Lighthouse parmi les outils que le site exécute sur lui-même, sur la machine où il est écrit, et lui donne un rôle : faire respecter les budgets de performance. Un budget est une limite convenue à l'avance : une page qui ralentit fait échouer un contrôle au lieu d'ouvrir un débat sur l'importance de quelques centaines de millisecondes.

Une section ultérieure de la même page cite PageSpeed Insights parmi les contrôles que les lecteurs peuvent lancer eux-mêmes. Elle précise qu'il exécute Lighthouse depuis les machines de Google plutôt que celles du site, avec des données réelles lorsqu'assez de personnes ont visité la page. Elle sépare volontairement les deux. La première section est le site qui corrige ses propres devoirs ; la seconde confie les mêmes questions à des outils qui ne lui appartiennent pas et ne le croient pas sur parole.

L'habitude qui donne son intérêt à un budget se retrouve dans un travail présenté ici sans rapport avec une note. Le récit de la [réduction du paquet de feuilles de style de 87 Ko à 31](/fr/portfolio/cut-the-stylesheet-bundle-from-87-kb-to-31-kb/) présente sa méthode en commençant par « Mesurer d'abord. » Les deux tiers de la plus grande feuille de style étaient une seule police encodée en base64 ; une troisième graisse n'a été préchargée que lorsque des données de terrain ont montré qu'elle fermait la plus longue chaîne critique ; un format d'image moderne pour le logo de la marque a été mesuré puis écarté, car il était plus lourd. Chaque décision est accompagnée d'une mesure, y compris celle allant dans l'autre sens. Les suggestions de Lighthouse demandent le même traitement : chacune reste une hypothèse jusqu'à ce qu'une mesure établisse son utilité.

## Où les problèmes surviennent

La plupart des erreurs avec Lighthouse viennent de ce qu'on fait dire au nombre davantage qu'il ne dit.

**Une seule exécution est prise pour la vérité.** Un rapport affiche 94, le suivant 87, et quelqu'un cherche une régression qui n'a jamais eu lieu. Comparez les médianes de plusieurs exécutions et choisissez délibérément l'agrégation dans Lighthouse CI : une assertion sans options retient la valeur la plus susceptible de réussir parmi toutes les exécutions, laissant donc passer une régression dès qu'une seule y échappe.

**Les exécutions sont lancées en parallèle.** Auditer dix adresses à la fois sur une machine les met en concurrence pour le processeur, la mémoire et le réseau, ce que le guide de variabilité déconseille explicitement. Exécutez-les l'une après l'autre ou sur plusieurs machines ; pour Lighthouse, plusieurs petites machines valent mieux qu'une grande.

**La note de laboratoire est prise pour l'expérience des visiteurs.** Un 98 sur le portable d'un développeur indique que la page peut être rapide ; seules les données de terrain disent si elle l'a été. Lisez la section de terrain dans PageSpeed Insights et attendez-vous à voir les chiffres de l'origine pour une page peu visitée.

**Les suggestions sont prises pour la note.** Les sections Opportunities (opportunités) et Diagnostics (diagnostics) ne comptent pas dans la note de performance ; elles ne la modifient que par les métriques qu'elles améliorent. Choisissez la suggestion qui devrait faire évoluer une métrique importante pour cette page, effectuez la modification et mesurez de nouveau.

**La perfection de la note devient l'objectif.** Le guide de notation qualifie 100 d'extrêmement difficile et précise que ce n'est pas attendu. Une fois la page dans la bande verte, les derniers points coûtent davantage qu'ils ne rapportent.

**La note maximale d'accessibilité est prise pour une page accessible.** Un 100 signifie que les audits automatiques ont réussi. Les contrôles manuels figurent à côté et ne sont jamais comptés : une page peut donc obtenir 100 et rester inutilisable au clavier.

## Pour aller plus loin

- [Introduction à Lighthouse](https://developer.chrome.com/docs/lighthouse/overview) — les modes d'exécution, les catégories et la documentation de chaque audit.
- [Notation de la performance dans Lighthouse](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring) — les poids des métriques par version, les courbes de notation et les bandes de couleur.
- [Note d'accessibilité de Lighthouse](https://developer.chrome.com/docs/lighthouse/accessibility/scoring) — la pondération des audits et l'exclusion des contrôles manuels.
- [Variabilité des notes](https://github.com/GoogleChrome/lighthouse/blob/main/docs/variability.md) — les sources de bruit, ce qui réduit chacune et l'intérêt d'exécutions répétées.
- [À propos de PageSpeed Insights](https://developers.google.com/speed/docs/insights/v5/about) — données de laboratoire et de terrain, 75e percentile et évaluation des Core Web Vitals.
- [Configuration de Lighthouse CI](https://github.com/GoogleChrome/lighthouse-ci/blob/main/docs/configuration.md) — recueillir plusieurs exécutions, écrire des assertions et choisir leur combinaison.

<https://engineer.company/fr/glossary/lighthouse/>
