NotRestoredReasons
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 stellt Berichtsdaten mit Gründen bereit, warum das aktuelle Dokument bei einer Navigation den Vorwärts-/Rückwärts-Cache (bfcache) nicht verwenden konnte.
Auf diese Objekte wird über die Eigenschaft PerformanceNavigationTiming.notRestoredReasons zugegriffen.
Instanzeigenschaften
childrenSchreibgeschützt-
Ein Array von
NotRestoredReasons-Objekten, eines für jedes im aktuellen Dokument eingebettete untergeordnete<iframe>. Die Objekte können Gründe enthalten, warum der oberste Frame aufgrund der untergeordneten Frames den bfcache nicht verwenden konnte. Jedes Objekt hat dieselbe Struktur wie das übergeordnete Objekt. Dadurch lassen sich beliebig viele Ebenen eingebetteter<iframe>-Elemente rekursiv darstellen. Hat der Frame keine untergeordneten Frames, ist das Array leer. Befindet sich das Dokument in einem ursprungsübergreifenden<iframe>, gibtchildrennullzurück. idSchreibgeschützt-
Ein String, der den Wert des
id-Attributs des<iframe>angibt, in dem sich das Dokument befindet (beispielsweise<iframe id="foo" src="...">). Befindet sich das Dokument nicht in einem<iframe>oder hat das<iframe>keinid-Attribut, gibtidnullzurück. nameSchreibgeschützt-
Ein String, der den Wert des
name-Attributs des<iframe>angibt, in dem sich das Dokument befindet (beispielsweise<iframe name="bar" src="...">). Befindet sich das Dokument nicht in einem<iframe>oder hat das<iframe>keinname-Attribut, gibtnamenullzurück. reasonsSchreibgeschützt-
Ein Array von
NotRestoredReasonDetails-Objekten, die jeweils einen Grund angeben, warum die Seite, zu der navigiert wurde, den bfcache nicht verwenden konnte. Befindet sich das Dokument in einem ursprungsübergreifenden<iframe>, gibtreasonsnullzurück. Das übergeordnete Dokument kann jedoch einenreason-Wert von"masked"anzeigen, wenn ein oder mehrere<iframe>-Elemente die Nutzung des bfcache für den obersten Frame verhindert haben. srcSchreibgeschützt-
Ein String, der den Pfad zur Quelle des
<iframe>angibt, in dem sich das Dokument befindet (beispielsweise<iframe src="exampleframe.html">). Befindet sich das Dokument nicht in einem<iframe>, gibtsrcnullzurück. urlSchreibgeschützt-
Ein String, der die URL der Seite, zu der navigiert wurde, oder des
<iframe>angibt. Befindet sich das Dokument in einem ursprungsübergreifenden<iframe>, gibturlnullzurück.
Instanzmethoden
toJSON()-
Gibt ein einfaches, JSON-serialisierbares Objekt zurück, das das
NotRestoredReasons-Objekt repräsentiert. Die Methode wird automatisch vonJSON.stringify()aufgerufen.
Beispiele
Beispiele finden Sie unter Gründe für die Verhinderung der bfcache-Nutzung überwachen.
Spezifikationen
| Spezifikation |
|---|
| HTML> # notrestoredreasons> |