NotRestoredReasonDetails: reason-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 reason-Eigenschaft der NotRestoredReasonDetails-Schnittstelle gibt eine Zeichenkette zurück, die den Grund beschreibt, warum die Seite daran gehindert wurde, den Vorwärts-/Rückwärts-Cache (bfcache) zu nutzen.

Wert

Eine Zeichenkette.

Es gibt viele verschiedene Gründe, warum eine Blockierung auftreten kann, und Browser können ihre eigenen spezifischen Gründe für eine Blockierung basierend auf ihrer Funktionsweise implementieren. Entwickler sollten vermeiden, sich auf eine spezifische Formulierung der Gründe zu verlassen, und darauf vorbereitet sein, dass neue Gründe hinzugefügt oder gelöscht werden.

Die im Spezifikationsentwurf aufgeführten Anfangswerte sind:

"fetch"

Während des Unloading wurde ein durch das aktuelle Dokument gestarteter Fetch (z.B. über fetch()) abgebrochen, während er läuft. Infolgedessen befand sich die Seite nicht in einem stabilen Zustand, der im bfcache gespeichert werden konnte.

"lock"

Während des Unloading wurden gehaltene Sperren und Sperranfragen beendet, sodass die Seite nicht in einem stabilen Zustand war, der im bfcache gespeichert werden konnte.

"masked"

Der genaue Grund ist aus Datenschutzgründen verborgen. Dieser Wert kann folgendes bedeuten:

  • Das aktuelle Dokument hat Kinder, die in einem cross-origin <iframe> enthalten sind, und diese haben die Speicherung im bfcache verhindert.
  • Das aktuelle Dokument konnte aus benutzerspezifischen Gründen des User-Agents nicht im bfcache gespeichert werden.

Die ursprüngliche Navigation, die das aktuelle Dokument erstellt hat, hat zu einem Fehler geführt, und die Speicherung des resultierenden Fehlerdokuments im bfcache wurde verhindert.

"parser-aborted"

Das aktuelle Dokument hat das initiale HTML-Parsing nie abgeschlossen, und die Speicherung des unvollständigen Dokuments im bfcache wurde verhindert.

"websocket"

Während des Unloading wurde eine offene WebSocket-Verbindung heruntergefahren, sodass die Seite nicht in einem stabilen Zustand war, der im bfcache gespeichert werden konnte.

Zusätzliche Blockierungsgründe können von einigen Browsern verwendet werden, zum Beispiel:

"unload-listener"

Die Seite registriert einen unload-Handler, der die Nutzung des bfcache verhindert. Dies dient als nützliche Warnung, da unload veraltet ist. Siehe Nutzungshinweise für weitere Informationen.

"response-cache-control-no-store"

Die Seite verwendet no-store als Cache-Control-Header-Wert.

Die Seite wurde von einer anderen Seite geöffnet, die noch eine Referenz zu dieser Seite hat, zum Beispiel durch die Funktionalität "Tab duplizieren".

Beispiele

Siehe Überwachung der bfcache-Blockierungsgründe für Beispiele.

Spezifikationen

Specification
HTML Standard
# dom-not-restored-reason-details-reason

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch