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 der Navigation.currentEntry ändert.
Dieses Ereignis wird ausgelöst bei:
-
Navigationen im selben Dokument (z. B.
back()odertraverseTo()). -
Ersetzungen (d.h. ein Aufruf von
navigate()mithistoryaufreplacegesetzt). -
Anderen Aufrufen, die den Zustand des Eintrags ändern (z. B.
updateCurrentEntry()oder derHistory.replaceState()-Aufruf der History API).
Dieses Ereignis wird ausgelöst, nachdem die Navigation festgeschrieben wurde, was bedeutet, dass die sichtbare URL geändert wurde und das NavigationHistoryEntry-Update erfolgt ist. Es ist nützlich für die Migration von der Nutzung älterer API-Funktionen wie den hashchange- oder popstate-Ereignissen.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("currententrychange", (event) => { })
oncurrententrychange = (event) => { }
Ereignistyp
Ein NavigationCurrentEntryChangeEvent. Erbt von Event.
Beispiele
Berichterstattung von Navigationsdaten:
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
Einrichtung eines Ereignisses pro Eintrag:
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Spezifikationen
| Spezifikation |
|---|
| HTML # event-currententrychange |