History : méthode back()
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 méthode back() de l'interface History fait revenir le navigateur d'une page dans l'historique de session.
Elle a le même effet que d'appeler history.go(-1). S'il n'y a pas de page précédente, cet appel de méthode n'a aucun effet.
Cette méthode est asynchrone. Ajoutez un écouteur pour l'évènement popstate afin de déterminer quand la navigation est terminée.
Syntaxe
back()
Paramètres
Aucun.
Valeur de retour
Aucune (undefined).
Exceptions
SecurityErrorDOMException-
Levée si le document associé n'est pas entièrement actif. Les navigateurs limitent également la fréquence des navigations et peuvent lever cette erreur, générer un avertissement ou ignorer l'appel si celui-ci est effectué trop fréquemment.
Exemples
L'exemple court suivant fait en sorte qu'un bouton sur la page navigue d'une entrée en arrière dans l'historique de session.
HTML
<button id="revenir-en-arriere">Aller en arrière !</button>
JavaScript
document.getElementById("revenir-en-arriere").addEventListener("click", () => {
history.back();
});
Spécifications
| Spécification |
|---|
| HTML # dom-history-back-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
History - Travailler avec l'API History