Document: thuộc tính prerendering

Giá trị

Một boolean. Trả về true nếu tài liệu hiện đang trong quá trình prerendering, và false nếu không. false sẽ được trả về cho các tài liệu đã hoàn tất prerendering và các tài liệu không được prerender.

Ví dụ

Để chạy một hoạt động trong khi trang đang prerendering, bạn có thể kiểm tra thuộc tính prerendering. Ví dụ: bạn có thể chạy một số analytics:

if (document.prerendering) {
  analytics.sendInfo("đã đến đây trong quá trình prerendering!");
}

Khi một tài liệu prerendered được kích hoạt, PerformanceNavigationTiming.activationStart được đặt thành một giá trị DOMHighResTimeStamp đại diện cho thời gian giữa khi prerendering bắt đầu và tài liệu thực sự được kích hoạt. Hàm sau có thể kiểm tra các trang prerendering và prerendered:

function pagePrerendered() {
  return (
    document.prerendering ||
    performance.getEntriesByType("navigation")[0]?.activationStart > 0
  );
}

Khi trang prerendered được kích hoạt bởi người dùng xem trang, sự kiện prerenderingchange sẽ được kích hoạt. Điều này có thể được sử dụng để kích hoạt các hoạt động trước đây sẽ được bắt đầu theo mặc định khi tải trang nhưng bạn muốn trì hoãn cho đến khi trang thực sự được người dùng xem. Đoạn mã sau thiết lập một trình lắng nghe sự kiện để chạy một hàm khi prerendering đã kết thúc, trên một trang prerendered, hoặc chạy ngay lập tức trên một trang không prerendered:

if (document.prerendering) {
  document.addEventListener("prerenderingchange", initAnalytics, {
    once: true,
  });
} else {
  initAnalytics();
}

Để đo lường tần suất một prerender được kích hoạt, kết hợp cả ba API: document.prerendering để phát hiện các trường hợp trang hiện đang prerendering, prerenderingchange để theo dõi kích hoạt trong trường hợp đó, và activationStart để kiểm tra các trường hợp trang đã được prerender trong quá khứ.

if (document.prerendering) {
  document.addEventListener(
    "prerenderingchange",
    () => {
      console.log("Prerender được kích hoạt sau khi tập lệnh này chạy");
    },
    { once: true },
  );
} else if (performance.getEntriesByType("navigation")[0]?.activationStart > 0) {
  console.log("Prerender được kích hoạt trước khi tập lệnh này chạy");
} else {
  console.log("Lần tải trang này không phải qua prerendering");
}

Đặc tả kỹ thuật

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

Xem thêm

• Speculation Rules API
• Sự kiện prerenderingchange
• Thuộc tính PerformanceNavigationTiming.activationStart