Panduan Migrasi Lighthouse v3

Panduan ini ditujukan untuk pengguna Lighthouse v2 yang:

  • Jalankan Lighthouse dari Node atau command line.
  • Mengandalkan output JSON Lighthouse.

Jika hal ini tidak berlaku untuk Anda, alur kerja Anda untuk menjalankan Lighthouse sebagian besar sama. Lihat Mengumumkan Lighthouse 3.0 untuk mengetahui ringkasan fitur dan perubahan baru.

Perubahan pemanggilan

Lighthouse kini menghitung performa simulasi secara default dan setelan throttling telah banyak diubah.

Flag CLI

Skenario Flag v2 Flag v3
Throttling 3G DevTools Tidak ada (perilaku default) --throttling-method=devtools
Tanpa Throttling --disable-network-throttling --disable-cpu-throttling --throttling-method=provided
Throttling Jaringan, Tanpa Throttling CPU --disable-cpu-throttling --throttling-method=devtools --throttling.cpuSlowdownMultiplier=1
Menjalankan Audit Performa --perf --preset=perf
Menjalankan Audit Konten Campuran --mixed-content --preset=mixed-content

Modul Node

Di Lighthouse v3, modul Node menerima opsi konfigurasi yang sama dengan CLI. Perubahan ini merupakan perubahan yang menyebabkan gangguan karena banyak opsi ini diabaikan di v2, sedangkan sekarang opsi tersebut benar-benar akan memengaruhi cara kerja 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);
}

Perubahan output

Format tingkat atas baru dalam output JSON

Objek JSON yang ditampilkan Lighthouse v3 kini berisi tiga properti tingkat atas:

  • lhr. Hasil audit. Singkatan dari "Hasil Lighthouse". Pada dasarnya, ini adalah objek tingkat teratas di v2, tetapi v3 juga memperkenalkan perubahan yang menyebabkan gangguan pada bentuk objek ini. Lihat Perubahan pada objek hasil.
  • artifacts. Data yang dikumpulkan dari Chrome saat melakukan audit. Sebelumnya, properti ini tercampur dengan properti LHR.
  • report. HTML/JSON/CSV laporan yang diformat sebagai string.

Perubahan pada objek hasil

Seperti yang disebutkan dalam Format baru tingkat teratas dalam output JSON, hasil audit tidak tersedia melalui properti lhr. Di v2, konten objek ini pada dasarnya adalah output JSON tingkat atas. Namun, bentuk objek ini sendiri telah berubah di v3. Tabel di bawah mencantumkan semua perubahan.

  • Jika baris memiliki nilai di kolom v2 dan v3, artinya Anda harus mengganti referensi apa pun ke properti v2 dalam kode dengan yang setara dengan v3.
  • Jika baris tidak memiliki nilai di kolom v3, kolom Catatan akan menjelaskan opsi Anda.
  • Perhatikan bahwa item seperti ID mewakili teks placeholder.
Properti v2 Setara v3 Catatan
initialUrl requestedUrl
url finalUrl
generatedTime fetchedTime
reportCategories categories Diubah dari array menjadi objek dengan kunci.
reportGroups categoryGroups
audits.ID.name audits.ID.id
audits.ID.description audits.ID.title
audits.ID.helpText audits.ID.description
audits.ID.scoringMode audits.ID.scoreDisplayMode Kemungkinan nilai telah diperluas menjadi numeric|binary|manual|informative|not-applicable|error.
audits.ID.score audits.ID.score Skor selalu berupa angka antara 0 dan 1 (bukan 0-100) jika scoreDisplayMode berupa numerik atau biner. Skor selalu null untuk mode tampilan lainnya karena tidak ada konsep lulus/gagal.
audits.ID.displayValue audits.ID.displayValue Sekarang dapat berupa array argumen bergaya printf untuk interpolasi string.
audits.ID.debugString audits.ID.explanation audits.ID.errorMessage audits.ID.warnings Nilai debugString telah dikonversi menjadi salah satu dari tiga properti di atas, bergantung pada intent-nya.
audits.ID.details audits.ID.details Struktur detail telah diubah agar lebih mudah digunakan. Setiap entri di .items adalah objek dengan kunci yang andal, bukan any[].
audits.ID.error audits.ID.scoreDisplayMode === 'error'
audits.ID.notApplicable audits.ID.scoreDisplayMode === 'not-applicable'
audits.ID.informative audits.ID.scoreDisplayMode === 'informative'
audits.ID.manual audits.ID.scoreDisplayMode === 'manual'
audits.ID.extendedInfo Dihapus. Sebagai gantinya, gunakan details.