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

Spezifikationen

Specification
HTML
# notrestoredreasons

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
NotRestoredReasons
Experimental
children
Experimental
id
Experimental
name
Experimental
reasons
Experimental
src
Experimental
toJSON
Experimental
url
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch