PerformanceNavigationTiming: Eigenschaft notRestoredReasons

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die schreibgeschützte Eigenschaft notRestoredReasons der Schnittstelle PerformanceNavigationTiming gibt ein NotRestoredReasons-Objekt zurück, das Berichtsdatensätze zu den Gründen liefert, warum das aktuelle Dokument bei einer Navigation daran gehindert wurde, den Back/Forward Cache (bfcache) zu verwenden.

Wert

Wenn das assoziierte PerformanceNavigationTiming-Objekt eine Verlauf-Navigation darstellt, gibt notRestoredReasons ein NotRestoredReasons-Objekt zurück.

Wenn das PerformanceNavigationTiming-Objekt keine Verlauf-Navigation darstellt, wird notRestoredReasons null zurückgeben. Dies ist nützlich, um festzustellen, ob bfcache für eine bestimmte Navigation nicht relevant ist (im Gegensatz zu notRestoredReasons, die nicht unterstützt werden würden, in diesem Fall würde undefined zurückgegeben).

Note: notRestoredReasons kann null zurückgeben, obwohl der Navigationstyp als Vorwärts/Rückwärts-Navigation gemeldet wird. Diese Umstände umfassen das Duplizieren einer Vorwärts/Rückwärts-Navigation in einem neuen Tab und das Wiederherstellen eines Vorwärts/Rückwärts-Navigations-Tabs nach einem Browser-Neustart. In solchen Fällen kopieren einige Browser den Navigationstyp aus dem Original-Tab, aber da dies tatsächlich keine Vorwärts/Rückwärts-Navigationsvorgänge sind, gibt notRestoredReasons null zurück.

Beispiele

PerformanceNavigationTiming-Daten können mithilfe der Performance.getEntriesByType() oder des PerformanceObserver aus der Performance-Zeitleiste abgerufen werden.

Zum Beispiel könnte die folgende Funktion aufgerufen werden, um alle PerformanceNavigationTiming-Objekte, die derzeit in der Performance-Zeitleiste vorhanden sind, zurückzugeben und deren notRestoredReasons zu protokollieren:

js
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);
  }
}

Die Eigenschaft PerformanceNavigationTiming.notRestoredReasons gibt ein Objekt mit der folgenden Struktur zurück, das die Gründe angibt, warum das aktuelle Dokument daran gehindert wurde, den bfcache zu verwenden. In diesem Beispiel hat der oberste Rahmen keine eingebetteten <iframe>-Kinder:

js
{
  children: [],
  id: null,
  name: null,
  reasons: [
    { reason: "unload-listener" }
  ],
  src: "",
  url: "example.com",
}

Spezifikationen

Specification
Navigation Timing Level 2
# dom-performancenavigationtiming-notrestoredreasons

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch