History : méthode go()

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.

Voir la compatibilité complète
En savoir plus

La méthode go() de l'interface History charge une page spécifique à partir de l'historique de session. Vous pouvez l'utiliser pour avancer et reculer dans l'historique en fonction de la valeur d'un paramètre.

Cette méthode est asynchrone. Ajoutez un écouteur pour l'évènement popstate afin de déterminer quand la navigation est terminée.

Syntaxe

go()
go(delta)

Paramètres

delta Facultatif: La position dans l'historique vers laquelle vous souhaitez vous déplacer, par rapport à la page actuelle. Une valeur négative recule, une valeur positive avance. Par exemple, history.go(2) avance de deux pages et history.go(-2) recule de deux pages. Si aucune valeur n'est passée ou si delta est égal à 0, cela a le même résultat que d'appeler location.reload().

Valeur de retour

Aucune (undefined).

Exceptions

SecurityError DOMException: Levée si le document associé n'est pas entièrement actif. Les navigateurs limitent également les navigations et peuvent lever cette erreur, générer un avertissement ou ignorer l'appel s'il est appelé trop fréquemment.