PerformanceNavigationTiming: notRestoredReasons property
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.
Thuộc tính chỉ đọc notRestoredReasons của giao diện PerformanceNavigationTiming trả về một đối tượng NotRestoredReasons cung cấp dữ liệu báo cáo về lý do tài liệu hiện tại bị chặn không cho dùng back/forward cache (bfcache) khi điều hướng.
Giá trị
Khi đối tượng PerformanceNavigationTiming liên quan biểu thị một điều hướng trong lịch sử, notRestoredReasons trả về một đối tượng NotRestoredReasons.
Khi đối tượng PerformanceNavigationTiming không biểu thị một điều hướng trong lịch sử, notRestoredReasons sẽ trả về null. Điều này hữu ích để xác định liệu bfcache có liên quan tới một điều hướng cụ thể hay không (khác với trường hợp notRestoredReasons không được hỗ trợ, khi đó nó sẽ trả về undefined).
Note:
notRestoredReasons có thể trả về null dù kiểu điều hướng được báo cáo là điều hướng back/forward. Những trường hợp này bao gồm việc nhân bản một điều hướng back/forward sang tab mới và khôi phục một tab điều hướng back/forward sau khi trình duyệt khởi động lại. Trong các trường hợp đó, một số trình duyệt sao chép kiểu điều hướng từ tab gốc, nhưng vì đây không thực sự là điều hướng back/forward nên notRestoredReasons trả về null.
Ví dụ
PerformanceNavigationTiming có thể được lấy từ performance timeline bằng Performance.getEntriesByType() hoặc PerformanceObserver.
Ví dụ, bạn có thể gọi hàm sau để trả về mọi đối tượng PerformanceNavigationTiming hiện có trong performance timeline và ghi lại notRestoredReasons của chúng:
function returnNRR() {
const navEntries = performance.getEntriesByType("navigation");
for (let i = 0; i < navEntries.length; i++) {
console.log(`Navigation entry ${i}`);
let navEntry = navEntries[i];
console.log(navEntry.notRestoredReasons);
}
}
Thuộc tính PerformanceNavigationTiming.notRestoredReasons trả về một đối tượng có cấu trúc sau, cung cấp lý do tài liệu hiện tại bị chặn không cho dùng bfcache. Trong ví dụ này frame cấp cao nhất không có bất kỳ <iframe> con nào:
{
"children": [],
"id": null,
"name": null,
"reasons": [{ "reason": "unload-listener" }],
"src": "",
"url": "example.com"
}
Thông số kỹ thuật
| Specification |
|---|
| Navigation Timing Level 2 # dom-performancenavigationtiming-notrestoredreasons |