NavigationHistoryEntry

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

L'interface NavigationHistoryEntry de l'API Navigation représente une seule entrée de l'historique de navigation.

Ces objets sont couramment accessibles avec la propriété Navigation.currentEntry et la méthode Navigation.entries().

L'API Navigation n'expose que les entrées de l'historique créées dans le contexte de navigation actuel et ayant la même origine que la page actuelle (par exemple, pas les navigations à l'intérieur des <iframe> intégrés, ni les navigations inter-origines), fournissant une liste précise de toutes les entrées de l'historique précédentes uniquement pour votre application. Cela rend la traversée de l'historique beaucoup moins fragile qu'avec l'ancienne API History.

Propriétés d'instance

Hérite des propriétés de son parent, EventTarget.

id Lecture seule: Retourne un id de l'entrée de l'historique. Il s'agit d'une valeur unique générée par l'agent utilisateur qui représente toujours une entrée d'historique spécifique, utile pour la corréler avec une ressource externe telle qu'un cache de stockage.
index Lecture seule: Retourne l'index de l'entrée de l'historique dans la liste des entrées de l'historique (c'est-à-dire la liste retournée par Navigation.entries()), ou -1 si l'entrée n'apparaît pas dans la liste.
key Lecture seule: Retourne la key de l'entrée de l'historique. Il s'agit d'une valeur unique générée par l'agent utilisateur qui représente le créneau de l'entrée dans la liste des entrées plutôt que l'entrée elle-même. Elle est utilisée pour naviguer vers ce créneau particulier avec Navigation.traverseTo(). La 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).
sameDocument Lecture seule: Retourne true si cette entrée de l'historique concerne le même document que la valeur actuelle de Document, sinon false.
url Lecture seule: Retourne l'URL absolue de cette entrée de l'historique. Si l'entrée correspond à un document différent de celui actuel (comme lorsque la propriété sameDocument est false), et que ce document a été récupéré avec un en-tête Referrer-Policy défini sur no-referrer ou origin, la propriété retourne null.

Méthodes d'instance

Hérite des méthodes de son parent, EventTarget.

getState(): Retourne une copie de l'état disponible associé à cette entrée de l'historique.

Évènements

dispose: Déclenché lorsque l'entrée ne fait plus partie de la liste des entrées de l'historique.

Exemples

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.
    },
  });
});

Spécifications

Spécification
HTML # the-navigationhistoryentry-interface

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 14 sept. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu