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

Das NotRestoredReasons Interface der Performance API liefert Berichtsdaten, die die Gründe enthalten, warum das aktuelle Dokument daran gehindert wurde, den back/forward Cache (bfcache) bei der Navigation zu nutzen.

Diese Objekte sind über die PerformanceNavigationTiming.notRestoredReasons Eigenschaft zugänglich.

Instanzeigenschaften

children Schreibgeschützt Experimentell: Ein Array von NotRestoredReasons Objekten, eines für jedes untergeordnete <iframe>, das im aktuellen Dokument eingebettet ist. Hier können Gründe enthalten sein, warum das übergeordnete Frame im Zusammenhang mit den untergeordneten Frames blockiert wurde. Jedes Objekt hat die gleiche Struktur wie das übergeordnete Objekt — auf diese Weise können beliebig viele Ebenen von eingebetteten <iframe>s rekursiv im Objekt dargestellt werden. Wenn das Frame keine Kinder hat, ist das Array leer; wenn das Dokument in einem Cross-Origin-<iframe> ist, gibt children null zurück.
id Schreibgeschützt Experimentell: Ein String, der den id Attributwert des <iframe> darstellt, in dem das Dokument enthalten ist (zum Beispiel <iframe id="foo" src="...">). Wenn das Dokument nicht in einem <iframe> ist oder das <iframe> keine id hat, gibt id null zurück.
name Schreibgeschützt Experimentell: Ein String, der den name Attributwert des <iframe> darstellt, in dem das Dokument enthalten ist (zum Beispiel <iframe name="bar" src="...">). Wenn das Dokument nicht in einem <iframe> ist oder das <iframe> keinen name hat, gibt name null zurück.
reasons Schreibgeschützt Experimentell: Ein Array von NotRestoredReasonDetails Objekten, von denen jedes einen Grund darstellt, warum die navigierte Seite daran gehindert wurde, den bfcache zu nutzen. Wenn das Dokument in einem Cross-Origin-<iframe> ist, gibt reasons null zurück, aber das übergeordnete Dokument könnte einen reason von "masked" anzeigen, wenn irgendwelche <iframe>s die Nutzung des bfcache für das oberste Frame blockiert haben.
src Schreibgeschützt Experimentell: Ein String, der den Pfad zur Quelle des <iframe> darstellt, in dem das Dokument enthalten ist (zum Beispiel <iframe src="exampleframe.html">). Wenn das Dokument nicht in einem <iframe> ist, gibt src null zurück.
url Schreibgeschützt Experimentell: Ein String, der die URL der navigierten Seite oder des <iframe> darstellt. Wenn das Dokument in einem Cross-Origin-<iframe> ist, gibt url null zurück.

Instanzmethoden

toJSON() Experimentell: Ein Serializer; gibt eine JSON-Darstellung des NotRestoredReasons Objekts zurück.

Beispiele

Siehe Überwachung von bfcache-Blockiergründen für Beispiele.

Spezifikationen

Specification
HTML Standard # notrestoredreasons

Browser-Kompatibilität

BCD tables only load in the browser