History : méthode forward()
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 forward() de l'interface History fait avancer le navigateur d'une page dans l'historique de session. Elle a le même effet que d'appeler history.go(1).
Cette méthode est asynchrone. Ajoutez un écouteur pour l'évènement popstate afin de déterminer quand la navigation est terminée.
Syntaxe
forward()
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 les navigations et peuvent lever cette erreur, générer un avertissement ou ignorer l'appel s'il est appelé trop fréquemment.
Exemples
Les exemples suivants créent un bouton qui avance d'une étape dans l'historique de session.
HTML
<button id="avancer">Aller en avant !</button>
JavaScript
document.getElementById("avancer").addEventListener("click", (e) => {
history.forward();
});
Spécifications
| Spécification |
|---|
| HTML # dom-history-forward-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
History - L'évènement
popstate - Travailler avec l'API History