NavigationHistoryEntry

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 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 Navigationen über Ursprünge hinweg), und bietet so eine genaue Liste aller vorherigen Verlaufsänderungen nur für Ihre App. Dies macht das Durchlaufen des Verlaufs weitaus stabiler als bei der älteren History API.

Instanz-Eigenschaften

Erbt Eigenschaften von ihrem Elternteil, EventTarget.

id Schreibgeschützt Experimentell

Gibt die id des Verlaufseintrags zurück. Dies ist ein eindeutiger, durch die Benutzer-Agentur generierter Wert, der immer einen bestimmten Verlaufseintrag darstellt, nützlich zur Korrelation mit einer externen Ressource wie einem Speichercache.

index Schreibgeschützt Experimentell

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

key Schreibgeschützt Experimentell

Gibt den key des Verlaufseintrags zurück. Dies ist ein eindeutiger, durch die Benutzer-Agentur generierter Wert, der den Slot des Verlaufseintrags in der Einträge-Liste anstatt den Eintrag selbst darstellt. Er wird verwendet, um zu diesem speziellen 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 das aktuelle Document-Objekt ist, andernfalls false.

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 mit dem Wert no-referrer oder origin abgerufen wurde, gibt die Eigenschaft null zurück.

Instanz-Methoden

Erbt Methoden von ihrem Elternteil, EventTarget.

getState() Experimentell

Gibt eine Kopie des verfügbaren Zustands zurück, der mit diesem Verlaufseintrag verbunden ist.

Ereignisse

dispose Experimentell

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

Browser-Kompatibilität

Siehe auch

• Moderne clientseitige Routing: die Navigation API
• Navigation API Erklärer
• Navigation API Live-Demo (Demo-Quellcode ansehen)