NavigationCurrentEntryChangeEvent
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'interface NavigationCurrentEntryChangeEvent de l'API Navigation est l'objet évènement pour l'évènement currententrychange, qui se déclenche lorsque la valeur Navigation.currentEntry a changée.
Cet évènement se déclenche pour les navigations dans le même document (par exemple, back() ou traverseTo()), les remplacements (c'est-à-dire un appel à navigate() avec history défini sur replace), ou d'autres appels qui modifient l'état de l'entrée (par exemple, updateCurrentEntry(), ou l'API History et sa méthode History.replaceState()).
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 plus anciennes de l'API, comme les évènements hashchange ou popstate.
Constructeur
-
Crée une nouvelle instance de l'objet
NavigationCurrentEntryChangeEvent.
Propriétés d'instance
Hérite des propriétés de son parent, Event.
fromLecture seule-
Retourne une
NavigationHistoryEntryvers laquelle la navigation a été effectuée. -
Retourne le type de la navigation qui a entraîné le changement.
Exemples
Rapport des données de navigation :
navigation.addEventListener("currententrychange", () => {
const donnee = navigation.currentEntry.getState();
submitAnalyticsData(donnee.analytics);
});
Configuration d'un évènement par entrée :
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Spécifications
| Spécification |
|---|
| HTML # the-navigationcurrententrychangeevent-interface |