Document: prerendering プロパティ

論理値。文書が現在事前レンダリング中であれば true を返し、そうでなければ false を返します。事前レンダリングが完了した文書や、事前レンダリングされていない文書に対しては false を返します。

ページが事前レンダリングされている間にアクティビティを実行するには、prerendering プロパティを調べます。例えば、アナリティクスを実行することができます。

if (document.prerendering) {
  analytics.sendInfo("got this far during prerendering!");
}

事前レンダリングされた文書がアクティブになると、PerformanceNavigationTiming.activationStart には、事前レンダリングが開始されてから実際に文書がアクティブになるまでの時間を表す DOMHighResTimeStamp 値が設定されます。以下の関数は、事前レンダリングが行われているページや完了したページを調べることができます。

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

事前レンダリングされたページがページを閲覧しているユーザーによってアクティブ化されると、prerenderingchange イベントが発生します。これは、前回まではページ読み込み時に既定で開始されていたアクティビティを、ページがユーザーによって実際に表示されるまで遅らせたい場合に使用することができます。以下のコードは、事前レンダリングされたページで、事前レンダリングが完了したら関数を実行する、または事前レンダリングされていないページですぐに関数を実行するイベントリスナーを設定します。

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

• 投機ルール API
• prerenderingchange イベント