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 Eintrag im Navigationsverlauf.

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

Die Navigation API zeigt nur Verlaufs-Einträge an, die im aktuellen Browsing-Kontext erstellt wurden und den gleichen Ursprung wie die aktuelle Seite haben (z.B. keine Navigationen innerhalb eingebetteter <iframe>s oder über Ursprünge hinweg), und bietet eine genaue Liste aller vorherigen Verlaufs-Einträge nur für Ihre App. Dies macht das Durchqueren des Verlaufs zu einer weitaus weniger fragilen Angelegenheit als mit der älteren History API.

EventTarget NavigationHistoryEntry

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, EventTarget.

id Schreibgeschützt

Gibt die id des Verlaufs-Eintrags zurück. Dies ist ein eindeutiger, vom Benutzeragent erzeugter Wert, der immer einen bestimmten Verlaufs-Eintrag repräsentiert und nützlich ist, um ihn mit einer externen Ressource wie einem Speichercache zu korrelieren.

index Schreibgeschützt

Gibt den Index des Verlaufs-Eintrags in der Liste der Verlaufs-Einträ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

Gibt den key des Verlaufs-Eintrags zurück. Dies ist ein eindeutiger, vom Benutzeragent erzeugter Wert, der den Slot des Verlaufs-Eintrags in der Eintragsliste anstelle des Eintrags selbst repräsentiert. Er wird verwendet, um diesen bestimmten 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

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

url Schreibgeschützt

Gibt die absolute URL dieses Verlaufs-Eintrags 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.

Instanz-Methoden

Erbt Methoden von seinem Elternteil, EventTarget.

getState()

Gibt einen Klon des verfügbaren Zustands zurück, der mit diesem Verlaufs-Eintrag assoziiert ist.

Ereignisse

dispose

Wird ausgelöst, wenn der Eintrag nicht mehr Teil der Verlaufs-Eintragsliste 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

Siehe auch