PerformanceLongAnimationFrameTiming

Mô tả

Các khung hoạt hình dài (LoAF) là các bản cập nhật kết xuất bị trì hoãn vượt quá 50ms. LoAF có thể dẫn đến các bản cập nhật giao diện người dùng (UI) chậm, khiến các điều khiển có vẻ không phản hồi và gây ra hiệu ứng hoạt hình và cuộn giật cục (không mượt mà). Điều này thường dẫn đến sự thất vọng của người dùng.

Giao diện PerformanceLongAnimationFrameTiming cung cấp bộ thông tin chi tiết sau về LoAF, cho phép các nhà phát triển thu hẹp nguyên nhân gốc rễ:

• Bộ timestamps chi tiết cho từng LoAF.
• Thông tin chi tiết về mỗi script góp phần tạo ra LoAF, thông qua thuộc tính PerformanceLongAnimationFrameTiming.scripts. Thuộc tính này trả về một mảng các đối tượng PerformanceScriptTiming, mỗi đối tượng cho mỗi script.

PerformanceLongAnimationFrameTiming kế thừa từ PerformanceEntry.

Thuộc tính phiên bản

Giao diện này trực tiếp định nghĩa các thuộc tính sau:

PerformanceLongAnimationFrameTiming.blockingDuration Read only Thử nghiệm

Trả về DOMHighResTimeStamp cho biết tổng thời gian tính bằng mili giây mà luồng chính bị chặn không phản hồi các tác vụ ưu tiên cao, chẳng hạn như đầu vào người dùng.

PerformanceLongAnimationFrameTiming.firstUIEventTimestamp Read only Thử nghiệm

Trả về DOMHighResTimeStamp cho biết thời gian của sự kiện UI đầu tiên (chẳng hạn như sự kiện chuột hoặc bàn phím) được xếp hàng trong khung hoạt hình hiện tại.

PerformanceLongAnimationFrameTiming.paintTime

Trả về timestamp khi giai đoạn kết xuất kết thúc và khung hoạt hình bắt đầu.

PerformanceLongAnimationFrameTiming.presentationTime

Trả về timestamp khi bản cập nhật UI thực sự được vẽ lên màn hình.

PerformanceLongAnimationFrameTiming.renderStart Read only Thử nghiệm

Trả về DOMHighResTimeStamp cho biết thời gian bắt đầu của chu kỳ kết xuất, bao gồm các callback Window.requestAnimationFrame(), tính toán style và layout, các callback ResizeObserver và các callback IntersectionObserver.

PerformanceLongAnimationFrameTiming.scripts Read only Thử nghiệm

Trả về một mảng các phiên bản PerformanceScriptTiming.

PerformanceLongAnimationFrameTiming.styleAndLayoutStart Read only Thử nghiệm

Trả về DOMHighResTimeStamp cho biết điểm bắt đầu của khoảng thời gian dành cho các tính toán style và layout cho khung hoạt hình hiện tại.

Nó cũng mở rộng các thuộc tính PerformanceEntry sau, đủ điều kiện và ràng buộc chúng như được mô tả:

PerformanceEntry.duration Read only Thử nghiệm

Trả về DOMHighResTimeStamp đại diện cho thời gian tính bằng mili giây để xử lý LoAF hoàn toàn.

PerformanceEntry.entryType Read only Thử nghiệm

Trả về loại mục, luôn là "long-animation-frame".

PerformanceEntry.name Read only Thử nghiệm

Trả về tên mục, luôn là "long-animation-frame".

PerformanceEntry.startTime Read only Thử nghiệm

Trả về DOMHighResTimeStamp đại diện cho thời gian khi khung hoạt hình bắt đầu.

Phương thức phiên bản

PerformanceLongAnimationFrameTiming.toJSON() Thử nghiệm

Trả về biểu diễn JSON của đối tượng PerformanceLongAnimationFrameTiming.

Ví dụ

Xem Long animation frame timing để biết các ví dụ liên quan đến Long Animation Frames API.

Thông số kỹ thuật

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

Xem thêm

• Long animation frame timing
• PerformanceScriptTiming