History
=======

L'interface **`History`** permet de manipuler l'historique de navigation du navigateur, soit la liste des pages visitées au sein de l'onglet ou fenêtre ou cadre dans lequelle la page actuelle est ouverte.

Propriétés
----------

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

`History.length` Lecture seule 

Retourne un `Integer` représentant le nombre d'élements dans l'historique de la session, y incluant la page actullement ouverte. Par exemple, pour une page chargée dans un nouvel onglet cette propriété retourne `1`.

`History.current` Lecture seule  
Non-standard

Obsolète

Retourne un `DOMString` de l'URL active dans l'historique de navigation. Cette propriété n'a jamais été rendu disponible au contenu web ni supporté par aucun autre navigateur. Utilisez plutôt `Location.href` (en-US).

`History.next` Lecture seule  
Non-standard

Obsolète

Retourne un `DOMString` de l'URL suivante dans l'historique de navigation. Cette propriété n'a jamais été rendu disponible au contenu web ni supporté par aucun autre navigateur.

`History.previous` Lecture seule  
Non-standard

Obsolète

Retourne un `DOMString` de l'URL précédente dans l'historique de navigation.

`History.state` (en-US) Lecture seule 

Retourne une value `any` représentant l'état le plus haut de l'historique de navigation. C'est une manière de vérifier cet état sans avoir à attendre un évenement `popstate`.

Méthodes
--------

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

`History.back()` (en-US)

Recule vers la page précédente dans l'historique de navigation, soit la même action que lorsque l'utilsateur clique le bouton Précédent du navigateur. Equivalent de `history.go(-1)`.

**Note :** Appeler cette méthode pour reculer plus loin que la première page de l'historique de navigation n'a aucun effet et ne déclenche pas d'exception.

`History.forward()` (en-US)

Avance vers la page suivante dans l'historique de navigation, soit la même action que lorsque l'utilsateur clique le bouton Suivant du navigateur. Equivalent de `history.go(1)`.

**Note :** Appeler cette méthode pour avancer plus loin que la page la plus récente de l'historique de navigation n'a aucun effet et ne déclenche pas d'exception.

`History.go()` (en-US)

Charge une page dans l'historique de navigation, identifiée par sa position relative à la page courante, par exemple `-1` pour la page précédente ou `1` pour la page suivante. Lorsque `integerDelta` sort du cadre de l'historique (aka. -1 alors qu'il n'y a pas de page précédente), cette méthode n'aura aucun effet et ne déclenchera pas d'exception. Appeler `go()` sans paramètres ou un paramètre autre qu'un `Integer` n'a aucun effet (sauf par Internet Explorer, qui supporte les URLs en String comme paramètre).

`History.pushState()` (en-US)

Insère les paramètres fournis dans la pile de l'historique de navigation avec un titre donné et, si fourni, l'URL. Les données sont traitées comme opaque par le DOM; il est nécessaire de spécifier chaque objet JavaScript devant être sérialisé. Notez que Firefox ignore actuellement le paramètre titre; pour plus d'informations, voir Manipuler l'historique du navigateur.

`History.replaceState()` (en-US)

Modifie la page la plus récente dans la pile de l'historique de navigation pour avoir les données, titre, et si spécifiée, URL. Les données sont traitées comme opaque par le DOM; il est nécessaire de spécifier chaque objet JavaScript devant être sérialisé. Notez que Firefox ignore actuellement le paramètre titre; pour plus d'informations, voir Manipuler l'historique du navigateur.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-history-interface |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* La propriété `Window.history` retourne l'historique de navigation de la session en cours.