Performance: now() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
Note: This feature is available in Web Workers.
Phương thức performance.now() trả về một dấu thời gian độ phân giải cao tính bằng mili giây. Nó biểu thị thời gian đã trôi qua kể từ Performance.timeOrigin (thời điểm điều hướng bắt đầu trong ngữ cảnh window, hoặc thời điểm worker được chạy trong ngữ cảnh Worker và ServiceWorker).
Cú pháp
now()
Tham số
Không có.
Giá trị trả về
Trả về một DOMHighResTimeStamp được đo bằng mili giây.
Mô tả
Performance.now so với Date.now
Không giống Date.now, các dấu thời gian do performance.now() trả về không bị giới hạn ở độ phân giải một mili giây. Thay vào đó, chúng biểu thị thời gian dưới dạng số dấu phẩy động với độ chính xác tới micro giây.
Ngoài ra, Date.now() có thể bị ảnh hưởng bởi điều chỉnh đồng hồ của hệ thống và người dùng, lệch đồng hồ, v.v. vì nó được tính tương đối với Unix epoch (1970-01-01T00:00:00Z) và phụ thuộc vào đồng hồ hệ thống.
Ngược lại, phương thức performance.now() tương đối với thuộc tính timeOrigin, là một đồng hồ đơn điệu: thời gian hiện tại của nó không bao giờ giảm và không chịu tác động của các điều chỉnh đó.
Các thay đổi đặc tả của performance.now
Ngữ nghĩa của phương thức performance.now() đã thay đổi giữa High Resolution Time Level 1 và Level 2.
| Thay đổi | Level 1 | Level 2 |
|---|---|---|
| Tính tương đối với | performance.timing.navigationStart |
Performance.timeOrigin |
| Điều kiện kích hoạt | Tài liệu được fetch hoặc lời nhắc unload (nếu có). | Tạo ngữ cảnh duyệt (nếu không có tài liệu trước đó), lời nhắc unload (nếu có), hoặc bắt đầu điều hướng (theo định nghĩa trong HTML, vài bước trước khi fetch). |
Phương thức performance.now() trước đây được tính tương đối với thuộc tính performance.timing.navigationStart từ đặc tả Navigation Timing. Điều này đã thay đổi và performance.now() hiện được tính tương đối với Performance.timeOrigin, giúp tránh rủi ro do thay đổi đồng hồ khi so sánh dấu thời gian giữa các trang web.
// Level 1 (có rủi ro do thay đổi đồng hồ)
currentTime = performance.timing.navigationStart + performance.now();
// Level 2 (không có rủi ro do thay đổi đồng hồ)
currentTime = performance.timeOrigin + performance.now();
Có chạy trong lúc ngủ hay không
Đặc tả (Level 2) yêu cầu performance.now() phải tiếp tục tăng khi hệ điều hành ngủ hoặc khi tiến trình trình duyệt bị đóng băng theo cách khác. Có vẻ như chỉ các trình duyệt trên Windows vẫn tiếp tục tăng trong lúc ngủ. Các lỗi trình duyệt liên quan trên hệ điều hành khác:
Tùy vào trường hợp sử dụng, sự khác biệt này có thể quan trọng hoặc không. Ví dụ, nếu bạn đang đo các thao tác ngắn như tải một hình ảnh, trong thời gian đó hệ thống khó có khả năng ngủ, thì điều này có thể không gây ra vấn đề nào. Nếu bạn đang đo một thao tác dài, bạn có thể thấy Date.now() hữu ích hơn để tránh các giới hạn này, vì độ chính xác cao của performance.now() có lẽ cũng không còn quá quan trọng.
Thêm chi tiết cũng có thể được tìm thấy trong issue đặc tả hr-time#115.
Yêu cầu bảo mật
Để bảo vệ chống lại tấn công dựa trên thời gian và fingerprinting, performance.now() được làm thô đi tùy theo việc tài liệu có phải là cross-origin isolated hay không.
- Độ phân giải trong ngữ cảnh cô lập: 5 micro giây
- Độ phân giải trong ngữ cảnh không cô lập: 100 micro giây
Bạn có thể dùng các thuộc tính Window.crossOriginIsolated và WorkerGlobalScope.crossOriginIsolated để kiểm tra xem tài liệu có được cô lập cross-origin hay không:
if (crossOriginIsolated) {
// Dùng measureUserAgentSpecificMemory
}
Ví dụ
Dùng performance.now()
Để xác định đã trôi qua bao nhiêu thời gian kể từ một thời điểm cụ thể trong mã của bạn, bạn có thể làm như sau:
const t0 = performance.now();
doSomething();
const t1 = performance.now();
console.log(`Call to doSomething took ${t1 - t0} milliseconds.`);
Thông số kỹ thuật
| Specification |
|---|
| High Resolution Time # dom-performance-now |