Navigation : évènement currententrychange
Baseline 2026
Nouvellement disponible
Depuis janvier 2026, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
L'évènement currententrychange de l'interface Navigation est déclenché lorsque la valeur de Navigation.currentEntry a changée.
Cet évènement se déclenche pour :
-
Les navigations dans le même document (par exemple,
back()outraverseTo()). -
Les remplacements (c'est-à-dire un appel à
navigate()avechistorydéfini surreplace). -
Les autres appels qui modifient l'état de l'entrée (par exemple,
updateCurrentEntry(), ou leHistory.replaceState()) de l'API History.
Cet évènement se déclenche après que la navigation a été validée, ce qui signifie que l'URL visible a changé et que la mise à jour de NavigationHistoryEntry a eu lieu. Il est utile pour migrer depuis l'utilisation de fonctionnalités d'API plus anciennes comme les évènements hashchange ou popstate.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("currententrychange", (event) => { })
oncurrententrychange = (event) => { }
Type d'évènement
Un objet NavigationCurrentEntryChangeEvent. Hérite de Event.
Exemples
Rapport des données de navigation :
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
Configuration d'un évènement par entrée :
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Spécifications
| Spécification |
|---|
| HTML # event-currententrychange |