Guide de migration Lighthouse v3

Ce guide s'adresse aux utilisateurs de la version 2 de Lighthouse qui:

• Exécutez Lighthouse à partir de Node ou de la ligne de commande.
• Utilisez la sortie JSON de Lighthouse.

Si ces conditions ne vous concernent pas, votre workflow d'exécution de Lighthouse est presque le même. Consultez la page Annonce de Lighthouse 3.0 pour obtenir un aperçu des nouvelles fonctionnalités et des modifications.

Modifications de l'appel

Lighthouse calcule désormais par défaut les performances simulées, et les paramètres de limitation ont été fortement modifiés.

Indicateurs de la CLI

Module de nœud

Dans Lighthouse v3, le module Nœud accepte les mêmes options de configuration que la CLI. Il s'agit d'une modification destructive, car bon nombre de ces options ont été ignorées dans la version 2, alors qu'elles concernent désormais l'exécution de 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);
}

Modifications des résultats

Nouveau format de premier niveau dans la sortie JSON

L'objet JSON renvoyé par Lighthouse v3 contient désormais trois propriétés de niveau supérieur:

• lhr. Résultats des audits. Abréviation de "Lighthouse Results". Il s'agissait essentiellement de l'objet de premier niveau dans la version 2, mais la version 3 apporte également des modifications destructives à la forme de cet objet. Consultez la section Modifications apportées à l'objet de résultats.
• artifacts : données collectées à partir de Chrome lors de l'audit. Elles étaient auparavant mélangées aux propriétés de la LHR.
• report : rapport au format HTML/JSON/CSV sous forme de chaîne.

Modifications apportées à l'objet de résultats

Comme indiqué dans Nouveau format de premier niveau dans la sortie JSON, les résultats des audits ne sont pas disponibles via la propriété lhr. Dans la version 2, le contenu de cet objet constituait essentiellement la sortie JSON de premier niveau. Toutefois, la forme de cet objet lui-même a changé dans la version 3. Le tableau ci-dessous liste toutes les modifications.

• Si une ligne contient une valeur à la fois dans les colonnes v2 et v3, cela signifie que vous devez remplacer toute référence à la propriété v2 dans votre code par l'équivalent v3.
• Si aucune valeur n'est associée à une ligne dans la colonne v3, la colonne Notes décrit les options disponibles.
• Notez que les éléments tels que ID représentent du texte d'espace réservé.