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, bevor Sie diese produktiv verwenden.

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 Nur lesbar

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 Nur lesbar

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 Nur lesbar

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 Nur lesbar

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

url Nur lesbar

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()

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

Ereignisse

dispose

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 Standard
# the-navigationhistoryentry-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch