Hướng dẫn di chuyển Lighthouse phiên bản 3

Hướng dẫn này dành cho những người dùng Lighthouse phiên bản 2:

  • Chạy Lighthouse từ Node hoặc dòng lệnh.
  • Dựa vào đầu ra JSON của Lighthouse.

Nếu những điều này không áp dụng cho bạn, thì quy trình làm việc để chạy Lighthouse hầu như giống nhau. Hãy xem bài viết Thông báo về Lighthouse 3.0 để biết thông tin tổng quan về các tính năng và thay đổi mới.

Thay đổi lệnh gọi

Lighthouse hiện tính toán hiệu suất mô phỏng theo mặc định và các chế độ cài đặt điều tiết đã thay đổi đáng kể.

Cờ CLI

Trường hợp Cờ v2 Cờ v3
Chế độ điều tiết mạng 3G trong Công cụ cho nhà phát triển Không có (hành vi mặc định) --throttling-method=devtools
Không điều tiết --disable-network-throttling --disable-cpu-throttling --throttling-method=provided
Hạn chế mạng, Không điều tiết CPU --disable-cpu-throttling --throttling-method=devtools --throttling.cpuSlowdownMultiplier=1
Chạy quy trình kiểm tra hiệu suất --perf --preset=perf
Chạy quy trình kiểm tra nội dung hỗn hợp --mixed-content --preset=mixed-content

Mô-đun nút

Trong Lighthouse phiên bản 3, mô-đun Nút chấp nhận các lựa chọn cấu hình tương tự như CLI. Đây là một thay đổi có thể gây lỗi trong trường hợp nhiều tuỳ chọn trong số này bị bỏ qua trong phiên bản 2, trong khi giờ đây, các tuỳ chọn này sẽ thực sự ảnh hưởng đến cách Lighthouse chạy.

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

Thay đổi đầu ra

Định dạng mới, cấp cao nhất trong kết quả JSON

Đối tượng JSON mà Lighthouse phiên bản 3 trả về hiện chứa 3 thuộc tính cấp cao nhất:

  • lhr. Kết quả của các quy trình kiểm tra. Viết tắt của "Kết quả Lighthouse". Về cơ bản, đây là đối tượng cấp cao nhất trong phiên bản 2, nhưng phiên bản 3 cũng giới thiệu các thay đổi có thể gây lỗi đối với hình dạng của đối tượng này. Xem Các thay đổi đối với đối tượng kết quả.
  • artifacts. Dữ liệu được thu thập từ Chrome trong khi kiểm tra. Trước đây, đối tượng này đã được kết hợp với các thuộc tính của LHR.
  • report. Báo cáo được định dạng HTML/JSON/CSV dưới dạng chuỗi.

Thay đổi đối với đối tượng kết quả

Như đã đề cập trong phần Định dạng mới, cấp cao nhất trong kết quả đầu ra JSON, kết quả của quy trình kiểm tra không có sẵn thông qua thuộc tính lhr. Trong phiên bản 2, nội dung của đối tượng này về cơ bản là đầu ra JSON cấp cao nhất. Tuy nhiên, hình dạng của đối tượng này đã thay đổi trong phiên bản 3. Bảng dưới đây liệt kê tất cả thay đổi.

  • Nếu một hàng có giá trị trong cả cột v2 và v3, thì tức là bạn nên thay thế mọi tham chiếu đến thuộc tính v2 trong mã bằng thuộc tính tương đương v3.
  • Khi một hàng không có giá trị trong cột v3, cột Ghi chú sẽ mô tả các lựa chọn của bạn.
  • Lưu ý rằng các mục như ID đại diện cho văn bản giữ chỗ.
Thuộc tính v2 Tương đương với phiên bản 3 Ghi chú
initialUrl requestedUrl
url finalUrl
generatedTime fetchedTime
reportCategories categories Đã thay đổi từ mảng thành đối tượng có khoá.
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 Các giá trị có thể đã được mở rộng thành numeric|binary|manual|informative|not-applicable|error.
audits.ID.score audits.ID.score Điểm số luôn là một số từ 0 đến 1 (không phải 0-100) khi scoreDisplayMode là số hoặc nhị phân. Điểm số luôn là null đối với các chế độ hiển thị khác vì không có khái niệm đạt/không đạt.
audits.ID.displayValue audits.ID.displayValue Hiện có thể là một mảng các đối số kiểu printf để nội suy chuỗi.
audits.ID.debugString audits.ID.explanation audits.ID.errorMessage audits.ID.warnings Các giá trị debugString đã được chuyển đổi thành một trong ba thuộc tính ở trên tuỳ thuộc vào ý định của chúng.
audits.ID.details audits.ID.details Cấu trúc của thông tin chi tiết đã thay đổi để dễ sử dụng hơn. Mỗi mục trong .items là một đối tượng có khoá đáng tin cậy thay vì 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 Đã xoá. Thay vào đó, hãy sử dụng details.