PerformanceScriptTiming

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Giao diện PerformanceScriptTiming được chỉ định trong Long Animation Frames API và cung cấp các chỉ số về các tập lệnh riêng lẻ góp phần vào các khung hoạt hình dài (LoAF).

Mô tả

Các khung hoạt hình dài (LoAF) là các cập nhật render bị trì hoãn vượt quá 50ms. LoAF có thể dẫn đến các 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 các 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 PerformanceScriptTiming (các phiên bản của nó được truy cập qua thuộc tính PerformanceLongAnimationFrameTiming.scripts) cung cấp tập hợp thông tin chi tiết sau về các tập lệnh riêng lẻ góp phần vào LoAF, cho phép các nhà phát triển thu hẹp nguyên nhân gốc rễ của chúng:

Một tập hợp chi tiết các dấu thời gian cho mỗi tập lệnh.
Danh tính và loại của invoker, tức là tính năng mà khi được gọi, đã chạy tập lệnh.
Thông tin chi tiết về từng tệp nguồn tập lệnh, bao gồm URL, tên hàm và vị trí ký tự góp phần vào LoAF.

PerformanceScriptTiming kế thừa từ PerformanceEntry.

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

Giao diện này mở rộng các thuộc tính PerformanceEntry sau cho các mục hiệu suất khung hoạt hình dài:

PerformanceEntry.duration Read only Experimental: Trả về một DOMHighResTimeStamp đại diện cho thời gian trôi qua tính bằng mili giây giữa thời điểm bắt đầu và kết thúc thực thi tập lệnh.
PerformanceEntry.entryType Read only Experimental: Trả về loại mục, luôn là "script".
PerformanceEntry.name Read only Experimental: Trả về tên mục, luôn là "script".
PerformanceEntry.startTime Read only Experimental: Trả về một DOMHighResTimeStamp đại diện cho thời điểm thực thi tập lệnh bắt đầu, tính bằng mili giây.

Giao diện này cũng hỗ trợ các thuộc tính sau:

PerformanceScriptTiming.executionStart Read only Experimental: Trả về một DOMHighResTimeStamp cho biết thời điểm quá trình biên dịch tập lệnh kết thúc và quá trình thực thi bắt đầu.
PerformanceScriptTiming.forcedStyleAndLayoutDuration Read only Experimental: Trả về một DOMHighResTimeStamp cho biết tổng thời gian, tính bằng mili giây, tập lệnh xử lý bố cục/kiểu bị ép buộc. Xem Avoid layout thrashing để hiểu nguyên nhân gây ra điều này.
PerformanceScriptTiming.invoker Read only Experimental: Trả về một giá trị chuỗi cho biết danh tính của tính năng mà khi được gọi, đã chạy tập lệnh.
PerformanceScriptTiming.invokerType Read only Experimental: Trả về một giá trị chuỗi cho biết loại tính năng mà khi được gọi, đã chạy tập lệnh.
PerformanceScriptTiming.pauseDuration Read only Experimental: Trả về một DOMHighResTimeStamp cho biết tổng thời gian, tính bằng mili giây, tập lệnh dành cho các thao tác đồng bộ "tạm dừng" (ví dụ: các lệnh gọi Window.alert() hoặc các XMLHttpRequest đồng bộ).
PerformanceScriptTiming.sourceCharPosition Read only Experimental: Trả về một số đại diện cho vị trí ký tự tập lệnh của tính năng tập lệnh góp phần vào LoAF.
PerformanceScriptTiming.sourceFunctionName Read only Experimental: Trả về một chuỗi đại diện cho tên của hàm góp phần vào LoAF.
PerformanceScriptTiming.sourceURL Read only Experimental: Trả về một chuỗi đại diện cho URL của tập lệnh.
PerformanceScriptTiming.window Read only Experimental: Trả về một tham chiếu đến đối tượng Window đại diện cho window của vùng chứa (tức là tài liệu cấp cao nhất hoặc <iframe>) trong đó tập lệnh gây ra LoAF được thực thi.
PerformanceScriptTiming.windowAttribution Read only Experimental: Trả về một giá trị liệt kê mô tả mối quan hệ của vùng chứa (tức là tài liệu cấp cao nhất hoặc <iframe>) trong đó tập lệnh gây ra LoAF được thực thi, so với cửa sổ đang chạy tài liệu hiện tại.