NavigationHistoryEntry : propriété key

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.

Voir la compatibilité complète
En savoir plus

La propriété en lecture seule key de l'interface NavigationHistoryEntry retourne la clé (key) de l'entrée de l'historique, ou une chaîne de caractères vide si le document actuel n'est pas entièrement actif. Il s'agit d'une valeur unique générée par l'agent utilisateur qui représente l'emplacement de l'entrée dans la liste des entrées. Elle est utilisée pour naviguer vers cet emplacement particulier avec Navigation.traverseTo(). La clé (key) est réutilisée par d'autres entrées qui remplacent l'entrée dans la liste (c'est-à-dire si le NavigateEvent.navigationType est replace).

Cela diffère d'un id d'une entrée de l'historique. Un id est une valeur unique générée par l'agent utilisateur qui représente toujours une entrée d'historique spécifique, plutôt que son emplacement dans la liste des entrées. C'est utile pour la corréler avec une ressource externe telle qu'un cache de stockage.

const actuelle = navigation.currentEntry;
console.log(actuelle.key);

Configurer un bouton d'accueil

function initBoutonAccueil() {
  // Obtient la clé de la première entrée chargée
  // afin que l'utilisateur·ice puisse toujours revenir à cette vue.
  const { key } = navigation.currentEntry;
  backToHomeButton.onclick = () => {
    navigation.traverseTo(key);
  };
}
// Intercepte les évènements de navigation, tels que les clics sur les
// liens, et les remplace par des navigations sur une seule page
navigation.addEventListener("navigate", (event) => {
  event.intercept({
    async handler() {
      // Navigue vers une vue différente,
      // mais le bouton « accueil » fonctionne toujours.
    },
  });
});