PerformanceEntry: duration property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Note: This feature is available in Web Workers.

Thuộc tính chỉ đọc duration trả về một timestamp là thời lượng của performance entry. Ý nghĩa của thuộc tính này phụ thuộc vào giá trị entryType của entry.

Giá trị

Một DOMHighResTimeStamp biểu thị thời lượng của performance entry. Nếu khái niệm thời lượng không áp dụng cho một chỉ số hiệu năng cụ thể, giá trị trả về là 0.

Ý nghĩa của thuộc tính này phụ thuộc vào giá trị entryType của performance entry:

event

Thời gian từ startTime của sự kiện đến lần sơn tiếp theo (làm tròn đến 8ms gần nhất).

first-input

Thời gian từ startTime của sự kiện nhập đầu tiên đến lần sơn tiếp theo (làm tròn đến 8ms gần nhất).

longtask

Thời gian trôi qua giữa lúc bắt đầu và kết thúc tác vụ, với độ phân giải 1ms.

measure

Thời lượng của phép đo.

Chênh lệch giữa các thuộc tính loadEventEndstartTime.

resource

Giá trị responseEnd của entry trừ đi giá trị startTime của entry.

Với các kiểu entry sau, duration không áp dụng, và trong trường hợp này giá trị luôn là 0:

  • element
  • largest-contentful-paint
  • layout-shift
  • mark
  • paint
  • taskattribution
  • visibility-state

Ví dụ

Sử dụng thuộc tính duration

Ví dụ sau ghi lại tất cả performance entry được quan sát có duration lớn hơn 0.

js
function perfObserver(list, observer) {
  list.getEntries().forEach((entry) => {
    if (entry.duration > 0) {
      console.log(`${entry.name}'s duration: ${entry.duration}`);
    }
  });
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["measure", "mark", "resource"] });

Thông số kỹ thuật

Specification
Performance Timeline
# dom-performanceentry-duration

Tương thích trình duyệt