Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

history.forward() — avancer dans l’historique

history.forward() avance d’une entrée dans l’historique de session du navigateur. Elle se comporte comme history.go(1) ; en l’absence d’entrée suivante, elle ne change rien.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

history.forward()

history.forward() ne prend aucun argument et renvoie undefined, pas une Promise. Elle se comporte comme history.go(1) : elle demande le passage à l’entrée suivante de l’historique de session. Cette entrée peut concerner le même document ou une autre page ; la méthode ne crée pas d’entrée.

Le parcours est asynchrone. Ne lisez pas le nouveau history.state immédiatement après l’appel. Dans l’exemple, les événements popstate synchronisent le parcours entre des entrées du même document. pushState() ne déclenche pas popstate à lui seul.

S’il n’y a pas d’entrée suivante, rien ne se passe. Un document qui n’est pas pleinement actif provoque une SecurityError ; le navigateur peut également bloquer la demande de navigation. Il s’agit d’une API de navigateur définie par HTML, et non d’une fonctionnalité ECMAScript ; la présence de Node 24 ne prouve pas qu’elle est prise en charge. Le standard indique qu’elle est prise en charge par tous les moteurs de navigateur actuels.

Exemples

const button = document.createElement('button');
button.textContent = 'Run history demo';
document.body.append(button);

button.addEventListener('click', () => {
  button.disabled = true;
  history.pushState({ step: 1 }, '');
  history.pushState({ step: 2 }, '');

  window.addEventListener('popstate', () => {
    console.log(history.state.step);
    window.addEventListener('popstate', () => {
      console.log(history.state.step);
      button.remove();
    }, { once: true });
    history.forward();
  }, { once: true });

  history.back();
}, { once: true });

Résultat

1
2

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources