NavigationHistoryEntry

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 NavigationHistoryEntry Interface der Navigation API repräsentiert einen einzelnen Navigationseintrag im Verlauf.

Diese Objekte werden häufig über die Eigenschaft Navigation.currentEntry und die Methode Navigation.entries() abgerufen.

Die Navigation API gibt nur Verlaufseinträge preis, die im aktuellen Browsing-Kontext erstellt wurden und denselben Ursprung wie die aktuelle Seite haben (z. B. keine Navigationen innerhalb eingebetteter <iframe>s oder Cross-Origin-Navigationen), und bietet eine genaue Liste aller vorherigen Verlaufseinträge nur für Ihre Anwendung. Dies macht die Navigation im Verlauf weitaus weniger fragil im Vergleich zur älteren History API.

EventTarget NavigationHistoryEntry

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, EventTarget.

id Schreibgeschützt Experimentell

Gibt die id des Verlaufseintrags zurück. Dies ist ein eindeutiger, vom UA generierter Wert, der immer einen bestimmten Verlaufseintrag repräsentiert und nützlich ist, um ihn mit einer externen Ressource wie einem Speichercache zu korrelieren.

index Schreibgeschützt Experimentell

Gibt den Index des Verlaufseintrags in der Liste der Verlaufseinträge zurück (also die Liste, die von Navigation.entries() zurückgegeben wird), oder -1, wenn der Eintrag nicht in der Liste erscheint.

key Schreibgeschützt Experimentell

Gibt den key des Verlaufseintrags zurück. Dies ist ein eindeutiger, vom UA generierter Wert, der den Slot des Verlaufseintrags in der Liste darstellt, anstatt den Eintrag selbst. Er wird verwendet, um genau diesen Slot über Navigation.traverseTo() zu navigieren. Der key wird von anderen Einträgen wiederverwendet, die den Eintrag in der Liste ersetzen (das heißt, wenn der NavigateEvent.navigationType replace ist).

sameDocument Schreibgeschützt Experimentell

Gibt true zurück, wenn dieser Verlaufseintrag für dasselbe document wie der aktuelle Document Wert ist, oder false andernfalls.

url Schreibgeschützt Experimentell

Gibt die absolute URL dieses Verlaufseintrags zurück. Wenn der Eintrag einem anderen Dokument als dem aktuellen entspricht (wie die sameDocument-Eigenschaft false ist) und dieses Dokument mit einem Referrer-Policy-Header no-referrer oder origin abgerufen wurde, gibt die Eigenschaft null zurück.

Instanzmethoden

Erbt Methoden von seinem Elternteil, EventTarget.

getState() Experimentell

Gibt einen Klon des verfügbaren Zustands zurück, der mit diesem Verlaufseintrag verknüpft ist.

Ereignisse

dispose Experimentell

Wird ausgelöst, wenn der Eintrag nicht mehr Teil der Verlaufseintragsliste ist.

Beispiele

js
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 navigations
navigation.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

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
NavigationHistoryEntry
Experimental
dispose event
Experimental
getState
Experimental
id
Experimental
index
Experimental
key
Experimental
sameDocument
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.
See implementation notes.

Siehe auch