PerformanceNavigationTiming: notRestoredReasons Eigenschaft

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 vor der Verwendung auf produktiven Webseiten.

Die notRestoredReasons schreibgeschützte Eigenschaft des PerformanceNavigationTiming-Interfaces gibt ein NotRestoredReasons-Objekt zurück, das Berichtsdaten zu den Gründen liefert, warum das aktuelle Dokument daran gehindert wurde, den Vor-/Zurück-Cache (bfcache) bei der Navigation zu nutzen.

Wert

Wenn das zugehörige 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 wird nicht unterstützt, in diesem Fall würde es undefined zurückgeben).

Hinweis:>notRestoredReasons kann null zurückgeben, obwohl der Navigationstyp als Vor-/Zurück-Navigation gemeldet wird. Diese Umstände beinhalten das Duplizieren einer Vor-/Zurück-Navigation in einem neuen Tab und das Wiederherstellen eines Vor-/Zurück-Navigations-Tabs nach einem Browser-Neustart. In solchen Fällen kopieren einige Browser den Navigationstyp vom Original-Tab, aber da es sich nicht wirklich um Vor-/Zurück-Navigationen handelt, gibt notRestoredReasons null zurück.

Beispiele

PerformanceNavigationTiming-Daten können aus der Performance-Zeitachse mit Performance.getEntriesByType() oder PerformanceObserver abgerufen werden.

Zum Beispiel könnten Sie die folgende Funktion aufrufen, um alle derzeit in der Performance-Zeitachse vorhandenen PerformanceNavigationTiming-Objekte 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 PerformanceNavigationTiming.notRestoredReasons-Eigenschaft gibt ein Objekt mit folgender Struktur zurück, das die Gründe liefert, warum das aktuelle Dokument daran gehindert wurde, den bfcache zu nutzen. In diesem Beispiel hat der oberste Frame keine eingebetteten Kind-<iframe>s:

json
{
  "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

Siehe auch