Navigation: currententrychange-Ereignis
Baseline 2026
Neu verfügbar
Seit Januar 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 currententrychange-Ereignis der Navigation-Schnittstelle wird ausgelöst, wenn sich Navigation.currentEntry geändert hat.
Dieses Ereignis wird ausgelöst bei:
-
Navigationen innerhalb desselben Dokuments (z. B.
back()odertraverseTo()). -
Ersetzungen (d.h. einem Aufruf von
navigate(), bei demhistoryaufreplacegesetzt ist). -
Anderen Aufrufen, die den Zustand des Eintrags ändern (z. B.
updateCurrentEntry()oderHistory.replaceState()der History API).
Dieses Ereignis wird ausgelöst, nachdem die Navigation übernommen wurde. Das bedeutet, dass sich die sichtbare URL geändert hat und der NavigationHistoryEntry aktualisiert wurde. Es ist hilfreich, wenn Sie von älteren API-Funktionen wie den Ereignissen hashchange oder popstate umsteigen.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("currententrychange", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
oncurrententrychange = (event) => { }
Ereignistyp
Ein NavigationCurrentEntryChangeEvent. Erbt von Event.
Beispiele
Navigationsdaten erfassen:
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
Ein Ereignis für einen einzelnen Eintrag einrichten:
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Spezifikationen
| Spezifikation |
|---|
| HTML # event-currententrychange |