Lighthouse v3 Taşıma Kılavuzu

Bu kılavuz, aşağıdaki koşulları karşılayan Lighthouse v2 kullanıcıları içindir:

  • Lighthouse'u düğümden veya komut satırından çalıştırın.
  • Lighthouse'un JSON çıkışına güvenin.

Bu koşullar sizin için geçerli değilse Lighthouse'u çalıştırmak için kullandığınız iş akışı büyük ölçüde aynıdır. Yeni sürüme genel bakış için bkz. Announcing Lighthouse 3.0 özellikleri ve değişiklikleri takip etmektir.

Çağrı değişiklikleri

Lighthouse artık performans simülasyonunu varsayılan olarak hesaplıyor ve kısıtlama ayarları değiştirildi.

KSA İşaretleri

Senaryo v2 İşaretleri v3 Bayrakları
Geliştirici Araçları 3G Kısıtlaması Yok (varsayılan davranış) --throttling-method=devtools
Sınırlama yok --disable-network-throttling --disable-cpu-throttling --throttling-method=provided
Ağ Kısıtlaması, CPU Kısıtlaması Yok --disable-cpu-throttling --throttling-method=devtools --throttling.cpuSlowdownMultiplier=1
Performans Denetimleri Çalıştırma --perf --preset=perf
Karma İçerik Denetimleri Yap --mixed-content --preset=mixed-content

Düğüm Modülü

Lighthouse v3'te, Düğüm modülü CLI ile aynı yapılandırma seçeneklerini kabul eder. Bu seçeneklerin çoğunun 2. sürümde yoksayıldığı, ancak artık Lighthouse'un çalışma şeklini etkileyeceği için bu önemli bir değişikliktir.

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);
}

Çıkış değişiklikleri

JSON çıkışında yeni, üst düzey biçim

Lighthouse v3'ün döndürdüğü JSON nesnesi artık 3 üst düzey mülk içeriyor:

  • lhr Denetimlerin sonuçları. "Lighthouse Results"un kısaltması. Bu, temel olarak v2'deki üst düzey nesnedir ancak v3, bu nesnenin şeklinde de önemli değişiklikler sunar. Görüntüleyin Sonuç nesnesinde yapılan değişiklikler.
  • artifacts Denetleme sırasında Chrome'dan toplanan veriler. Bu, daha önce karışık LHR'nin özellikleriyle uyumludur.
  • report Biçimlendirilmiş rapor HTML/JSON/CSV dize olarak.

Sonuçlar nesnesinde yapılan değişiklikler

JSON çıkışında yeni, üst düzey biçim bölümünde belirtildiği gibi, denetim sonuçları artık lhr mülkü aracılığıyla kullanılabilir. v2'de bu nesnenin içeriği aslında üst düzey JSON çıkışı. Ancak bu nesnenin şekli, v3'te değişti. Aşağıdaki tablo tüm değişiklikleri listeler.

  • Bir satırın hem v2 hem de v3 sütunlarında değer varsa bu durum, v2 özelliğine ilişkin tüm referansları v3 eşdeğeriyle değiştirmeniz gerekir.
  • Bir satırın v3 sütununda değer olmadığında, Notlar sütununda seçenekleriniz.
  • ID gibi öğelerin yer tutucu metni temsil ettiğini unutmayın.
v2 Mülkü v3 Eşdeğeri Notlar
initialUrl requestedUrl
url finalUrl
generatedTime fetchedTime
reportCategories categories Diziden anahtarlanmış bir nesneye değiştirildi.
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 Olası değerler şu şekilde genişletildi: numeric|binary|manual|informative|not-applicable|error
audits.ID.score audits.ID.score scoreDisplayMode sayısal veya ikili olduğunda puanlar her zaman 0 ile 1 arasında bir sayı olur (0-100 değil). Diğer görüntüleme modlarında bunun olmaması nedeniyle puanlar her zaman null başarılı/başarısız kavramını ifade eder.
audits.ID.displayValue audits.ID.displayValue Artık dize interpolasyonu için Printf stili bağımsız değişkenler dizisi olabilir.
audits.ID.debugString audits.ID.explanation audits.ID.errorMessage audits.ID.warnings debugString değeri, yukarıdaki üç özellikten birine dönüştürüldü tercih edebilirsiniz.
audits.ID.details audits.ID.details Ayrıntıların yapısı daha tüketilebilir olacak şekilde değiştirildi. .items bölümündeki her giriş, any[] yerine güvenilir anahtarlar içeren bir nesnedir.
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 Kaldırıldı. Bunun yerine details politikasını kullanın.