NavigationCurrentEntryChangeEvent
Baseline
2026
Newly available
Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Das NavigationCurrentEntryChangeEvent Interface des Navigation API ist das Ereignisobjekt für das currententrychange Ereignis, das ausgelöst wird, wenn sich Navigation.currentEntry geändert hat.
Dieses Ereignis wird bei Navigationen im selben Dokument ausgelöst (z.B. back() oder traverseTo()), Ersetzungen (d.h. ein navigate()-Aufruf mit history auf replace gesetzt) oder anderen Aufrufen, die den Status des Eintrags ändern (z.B. updateCurrentEntry(), oder das History API's History.replaceState()).
Dieses Ereignis wird ausgelöst, nachdem die Navigation abgeschlossen ist, was bedeutet, dass die sichtbare URL geändert wurde und die Aktualisierung des NavigationHistoryEntry erfolgt ist. Es ist nützlich für die Migration von der Nutzung älterer API-Funktionen wie der hashchange oder popstate Ereignisse.
Konstruktor
-
Erstellt eine neue Instanz des
NavigationCurrentEntryChangeEventObjekts.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, Event.
fromSchreibgeschützt-
Gibt das
NavigationHistoryEntryzurück, von dem aus navigiert wurde. -
Gibt den Typ der Navigation zurück, die zu der Änderung geführt hat.
Beispiele
Navigationsdatenberichterstattung:
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
Einrichten eines ereignisbasierten Eintrags:
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Spezifikationen
| Specification |
|---|
| HTML # the-navigationcurrententrychangeevent-interface |