NavigationCurrentEntryChangeEvent

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 NavigationCurrentEntryChangeEvent-Interface der Navigation API ist das Ereignisobjekt für das currententrychange-Ereignis, welches ausgelöst wird, wenn sich die Navigation.currentEntry geändert hat.

Dieses Ereignis wird für Navigationen im selben Dokument ausgelöst (z.B. back() oder traverseTo()), Ersetzungen (d.h. ein Aufruf von navigate() mit history auf replace gesetzt), oder andere Aufrufe, die den Zustand des Eintrags ändern (z.B. updateCurrentEntry(), oder die History API mit History.replaceState()).

Dieses Ereignis wird ausgelöst, nachdem die Navigation bestätigt wurde, was bedeutet, dass sich die sichtbare URL geändert hat und das NavigationHistoryEntry aktualisiert wurde. Es ist nützlich für die Migration von der Nutzung älterer API-Funktionen wie der hashchange- oder popstate-Ereignisse.

Event NavigationCurrentEntryChangeEvent

Konstruktor

Erstellt eine neue Instanz des NavigationCurrentEntryChangeEvent-Objekts.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, Event.

from Schreibgeschützt

Gibt das NavigationHistoryEntry zurück, von dem aus navigiert wurde.

Gibt den Typ der Navigation zurück, die zu der Änderung geführt hat.

Beispiele

Navigation-Datenbericht:

js
navigation.addEventListener("currententrychange", () => {
  const data = navigation.currentEntry.getState();
  submitAnalyticsData(data.analytics);
});

Einrichten eines pro-Eintrag-Ereignisses:

js
navigation.addEventListener("currententrychange", () => {
  navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});

Spezifikationen

Specification
HTML
# the-navigationcurrententrychangeevent-interface

Browser-Kompatibilität

Siehe auch