NavigationHistoryEntry

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die NavigationHistoryEntry-Schnittstelle der Navigation API repräsentiert einen einzelnen Navigationseintrag in der Historie.

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

Die Navigation API stellt nur Historieneinträge bereit, 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 somit eine präzise Liste aller vorhergehenden Historieneinträge nur für Ihre App. Dies macht das Durchlaufen der Historie zu einem viel weniger fragilen Unterfangen als mit der älteren History API.

Instanzeigenschaften

Erbt Eigenschaften von ihrem Elternteil, EventTarget.

id Schreibgeschützt: Gibt die id des Historieneintrags zurück. Dies ist ein eindeutiger, vom Benutzeragenten generierter Wert, der immer einen spezifischen Historieneintrag darstellt und nützlich ist, um ihn mit einer externen Ressource wie einem Speicher-Cache zu korrelieren.
index Schreibgeschützt: Gibt den Index des Historieneintrags in der Liste der Historieneinträge zurück (das ist 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 Historieneintrags zurück. Dies ist ein eindeutiger, vom Benutzeragenten generierter Wert, der den Slot des Historieneintrags in der Eintragsliste darstellt, anstatt den Eintrag selbst. Er wird verwendet, um über Navigation.traverseTo() zu diesem bestimmten Slot zu navigieren. Der key wird von anderen Einträgen, die den Eintrag in der Liste ersetzen, wiederverwendet (d.h. wenn der NavigateEvent.navigationType replace ist).
sameDocument Schreibgeschützt: Gibt true zurück, wenn dieser Historieneintrag für dasselbe document wie der aktuelle Document-Wert ist, oder false andernfalls.
url Schreibgeschützt: Gibt die absolute URL dieses Historieneintrags zurück. Wenn der Eintrag auf ein anderes Dokument als das aktuelle verweist (wie die sameDocument-Eigenschaft false ist), und dieses Dokument mit einem Referrer-Policy-Header, der auf no-referrer oder origin gesetzt ist, abgerufen wurde, gibt die Eigenschaft null zurück.

Instanzmethoden

Erbt Methoden von ihrem Elternteil, EventTarget.

getState(): Gibt einen Klon des verfügbaren Zustands zurück, der mit diesem Historieneintrag verbunden ist.

Ereignisse

dispose Experimentell: Wird ausgelöst, wenn der Eintrag nicht mehr Teil der Historieneintragliste 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 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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden