History : propriété state
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété en lecture seule state de l'interface History retourne une valeur représentant l'état au sommet de la pile d'historique. C'est un moyen de consulter l'état sans avoir à attendre un évènement popstate.
Valeur
L'état au sommet de la pile d'historique. La valeur est null jusqu'à ce que la méthode pushState() ou replaceState() soit utilisée.
Exemples
Le code ci-dessous consigne la valeur de history.state avant d'utiliser la méthode pushState() pour pousser une valeur dans l'historique. La ligne suivante consigne à nouveau la valeur dans la console, montrant que history.state a maintenant une valeur.
// Doit être null, car nous n'avons pas encore modifié la pile d'historique.
console.log("History.state avant pushState : ", history.state);
// Maintenant, poussez quelque chose sur la pile
history.pushState({ name: "Exemple" }, "exemple pushState", "page3.html");
// Maintenant, l'état a une valeur.
console.log("History.state après pushState : ", history.state);
Spécifications
| Spécification |
|---|
| HTML # dom-history-state-dev |
Compatibilité des navigateurs
Voir aussi
- Travailler avec l'API History
- La méthode
History.pushState() - La méthode
History.replaceState() - La propriété
PopStateEvent.state