History

Propriétés d'instance

L'interface History n'hérite d'aucune propriété.

length Lecture seule

Retourne un entier (Integer) représentant le nombre d'éléments dans l'historique de session, y compris la page actuellement chargée. Par exemple, pour une page chargée dans un nouvel onglet, cette propriété retourne 1.

scrollRestoration

Permet aux applications web de définir explicitement le comportement par défaut de la restauration du défilement lors de la navigation dans l'historique. Cette propriété peut être soit auto, soit manual.

state Lecture seule

Retourne une valeur any représentant l'état au sommet de la pile d'historique. C'est une manière de consulter l'état sans avoir à attendre un évènement popstate.

Méthodes d'instance

L'interface History n'hérite d'aucune méthode.

back()

Cette méthode asynchrone accède à la page précédente de l'historique de session, comme lorsque l'utilisateur·ice clique sur le bouton Précédent du navigateur. Elle est équivalente à history.go(-1).

Appeler cette méthode pour revenir au-delà de la première page de l'historique de session n'a aucun effet et ne déclenche pas d'exception.

forward()

Cette méthode asynchrone accède à la page suivante de l'historique de session, comme lorsque l'utilisateur·ice clique sur le bouton Suivant du navigateur ; elle est équivalente à history.go(1).

Appeler cette méthode pour avancer au-delà de la page la plus récente de l'historique de session n'a aucun effet et ne déclenche pas d'exception.

go()

Charge de manière asynchrone une page de l'historique de session, identifiée par sa position relative à la page actuelle, par exemple -1 pour la page précédente ou 1 pour la page suivante. Si vous définissez une valeur hors limites (par exemple -1 lorsqu'il n'existe aucune page précédemment visitée dans l'historique de session), cette méthode n'a aucun effet et ne génère aucun message. Appeler go() sans paramètre ou avec la valeur 0 recharge la page actuelle.

pushState()

Ajoute les données fournies à la pile de l'historique de session avec le titre défini (et, si elle est fournie, l'URL). Le DOM traite les données comme opaques ; vous pouvez définir n'importe quel objet JavaScript qui peut être sérialisé. Notez que tous les navigateurs, à l'exception de Safari, ignorent actuellement le paramètre title. Pour plus d'informations, consultez Travailler avec l'API History.

replaceState()

Met à jour l'entrée la plus récente de la pile de l'historique avec les données et le titre définis et, si elle est fournie, l'URL. Le DOM traite les données comme opaques ; vous pouvez définir n'importe quel objet JavaScript qui peut être sérialisé. Notez que tous les navigateurs, à l'exception de Safari, ignorent actuellement le paramètre title. Pour plus d'informations, consultez Travailler avec l'API History.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet global history