NavigationHistoryEntry

Limited availability

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

Das NavigationHistoryEntry-Interface der Navigation API repräsentiert einen einzelnen Navigationseintrag im Verlauf.

Diese Objekte werden üblicherweise ü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 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 älteren History API.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, EventTarget.

id Schreibgeschützt: Gibt die id des 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.
index Schreibgeschützt: Gibt 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.
key Schreibgeschützt: Gibt den key des 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 über Navigation.traverseTo() zu navigieren. Der key wird von anderen Einträgen wiederverwendet, die den Eintrag in der Liste ersetzen (d.h. 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 wenn die sameDocument-Eigenschaft false ist), und dieses Dokument mit einem Referrer-Policy-Header abgerufen wurde, der auf no-referrer oder origin gesetzt ist, 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 verbunden ist.

Ereignisse

dispose: Wird 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 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