Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : propriété history

Baseline Widely available

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 history de l'interface Window retourne une référence à l'objet History, qui fournit une interface pour manipuler l'historique de session du navigateur (pages visitées dans l'onglet ou le cadre dans lequel la page courante est chargée).

Voir Manipuler l'historique du navigateur pour des exemples et des détails. En particulier, cet article explique les aspects de sécurité des méthodes pushState() et replaceState() dont il faut tenir compte avant de les utiliser.

Valeur

Une référence à l'objet History.

Exemples

js
history.back(); // similaire au bouton de retour
history.go(-1); // similaire à history.back();

Notes

Pour les pages de niveau supérieur, vous pouvez voir la liste des pages dans l'historique de session, accessible avec l'objet History, dans les menus déroulants du navigateur à côté des boutons précédent et suivant.

Pour des raisons de sécurité, l'objet History n'autorise pas le code non privilégié à accéder aux URL des autres pages présentes dans l'historique de session, mais il permet de naviguer dans l'historique de session.

Il n'existe aucun moyen d'effacer l'historique de session ou de désactiver la navigation arrière/avant depuis du code non privilégié. La solution la plus proche disponible est la méthode location.replace(), qui remplace l'élément actuel de l'historique de session par l'URL fournie.

Spécifications

Specification
HTML
# the-history-interface

Compatibilité des navigateurs