Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
NavigationHistoryEntry
Baseline 2026Newly available
Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
DasNavigationHistoryEntry-Interface derNavigation API repräsentiert einen einzelnen Navigationseintrag im Verlauf.
Diese Objekte werden üblicherweise über dieNavigation.currentEntry-Eigenschaft und dieNavigation.entries()-Methode aufgerufen.
Die Navigation API zeigt nur Verlaufs-Einträge an, die im aktuellen Browsing-Kontext erstellt wurden und denselben Ursprung wie die aktuelle Seite haben (z. B. keine Navigationen innerhalb eingebetteter<iframe>s oder Navigationen mit unterschiedlichen Ursprüngen), und liefert eine genaue Liste aller vorherigen Verlaufs-Einträge nur für Ihre App. Dies macht das Durchlaufen des Verlaufs viel weniger anfällig als mit der älterenHistory API.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil,EventTarget.
idSchreibgeschütztGibt die
iddes Verlaufs-Eintrags zurück. Dies ist ein eindeutiger, vom Benutzeragenten generierter Wert, der immer einen spezifischen Verlaufs-Eintrag darstellt und nützlich ist, um diesen mit einer externen Ressource, wie einem Speicher-Cache, zu korrelieren.indexSchreibgeschütztGibt den Index des Verlaufs-Eintrags in der Verlaufs-Einträge-Liste zurück (d.h. die Liste, die von
Navigation.entries()zurückgegeben wird), oder-1, wenn der Eintrag nicht in der Liste erscheint.keySchreibgeschütztGibt den
keydes Verlaufs-Eintrags zurück. Dies ist ein eindeutiger, vom Benutzeragenten generierter Wert, der den Slot des Verlaufs-Eintrags in der Eintragsliste anstelle des Eintrags selbst darstellt. Er wird verwendet, um zu diesem bestimmten Slot überNavigation.traverseTo()zu navigieren. Derkeywird von anderen Einträgen wiederverwendet, die den Eintrag in der Liste ersetzen (d.h. wenn derNavigateEvent.navigationTypereplaceist).sameDocumentSchreibgeschütztGibt
truezurück, wenn dieser Verlaufs-Eintrag für dasselbedocumentwie der aktuelleDocument-Wert ist, oderfalseandernfalls.urlSchreibgeschütztGibt die absolute URL dieses Verlaufs-Eintrags zurück. Wenn der Eintrag einem anderen Dokument als dem aktuellen entspricht (wie wenn die
sameDocument-Eigenschaftfalseist), und dieses Dokument mit einemReferrer-Policy-Header abgerufen wurde, der aufno-referreroderorigingesetzt ist, gibt die Eigenschaftnullzurück.
Instanz-Methoden
Erbt Methoden von seinem Elternteil,EventTarget.
getState()Gibt einen Klon des verfügbaren Zustands zurück, der mit diesem Verlaufs-Eintrag verbunden ist.
Ereignisse
disposeWird ausgelöst, wenn der Eintrag nicht mehr Teil der Verlaufs-Einträge-Liste ist.
Beispiele
function initHomeBtn() { // Get the key of the first loaded entry // so the user can always go back to this view. const { key } = navigation.currentEntry; backToHomeButton.onclick = () => { navigation.traverseTo(key); };}// Intercept navigate events, such as link clicks, and// replace them with single-page navigationsnavigation.addEventListener("navigate", (event) => { event.intercept({ async handler() { // Navigate to a different view, // but the "home" button will always work. }, });});Spezifikationen
| Specification |
|---|
| HTML # the-navigationhistoryentry-interface |