NavigationCurrentEntryChangeEvent
Baseline
2026
Neu verfügbar
Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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
| Spezifikation |
|---|
| HTML # the-navigationcurrententrychangeevent-interface |