Trang này được dịch bởi Cloud Translation API.

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 dữ liệu đầu ra JSON của Lighthouse.

Nếu bạn không thuộc những trường hợp trên, thì quy trình chạy Lighthouse của bạn hầu như sẽ giống nhau. Xem bài viết Thông báo về Lighthouse 3.0 để biết tổng quan về các tính năng mới các tính năng và thay đổi mới.

Thay đổi về lệnh gọi

Theo mặc định, Lighthouse tính toán hiệu suất mô phỏng và các chế độ điều tiết đã được sử dụng đã thay đổi.

Cờ CLI

Trường hợp	Cờ v2	Cờ v3
Điều tiết 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ế băng thông mạng, Không điều tiết CPU	`--disable-cpu-throttling`	`--throttling-method=devtools --throttling.cpuSlowdownMultiplier=1`
Chạy kiểm tra hiệu suất	`--perf`	`--preset=perf`
Chạy 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 khi nhiều tuỳ chọn trong số này đã bị bỏ qua trong phiên bản 2, trong khi giờ đây chúng 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 dữ liệu đầu ra 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ả 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 phần Thay đổi đối với đối tượng kết quả.
artifacts. Dữ liệu được thu thập từ Chrome trong quá trình kiểm tra. Trước đây, quy tắc này được xen kẽ bằng 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.

Các thay đổi đối với đối tượng kết quả

Như đã đề cập trong Định dạng mới, cấp cao nhất trong đầu ra JSON, kết quả kiểm tra hiện 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 bên dưới 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ì điều đó có nghĩa là rằng bạn nên thay thế mọi tham chiếu đến thuộc tính v2 trong mã của mình bằng v3 tương đương.
Khi một hàng không có giá trị trong cột v3, cột Ghi chú sẽ mô tả tùy 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 v3	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ó điểm 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 các chi tiết đã chuyển sang tính tiêu thụ nhiều hơn. Mỗi mục trong `.items` là đố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`.