NavigationHistoryEntry : méthode getState()
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.
La méthode getState() de l'interface NavigationHistoryEntry retourne un clone de l'état fourni par le·la développeur·euse associé à cette entrée de l'historique.
Syntaxe
js
getState()
Paramètres
Aucun.
Valeur de retour
Une valeur représentant l'état. Il peut s'agir de n'importe quel type de données structuré et clonable.
Si aucun état n'est défini ou si le document actuel n'est pas entièrement actif, elle retourne undefined.
Exceptions
Aucune.
Exemples
js
async function handleReload() {
// Met à jour l'état existant avec reload()
await navigation.reload({
state: { ...navigation.currentEntry.getState(), newState: 3 },
});
// Affiche l'état actuel dans la console
const current = navigation.currentEntry;
console.log(current.getState());
}
Spécifications
| Spécification |
|---|
| HTML # dom-navigationhistoryentry-getstate-dev |
Compatibilité des navigateurs
Voir aussi
- Routage moderne côté client : l'API Navigation (angl.)
- Présentation de l'API Navigation (angl.)
- Les méthodes qui permettent de mettre à jour l'état —
Navigation.navigate(),Navigation.reload()etNavigation.updateCurrentEntry()