CKTIS / JavaScript
history.go() — parcourir l’historique de session
history.go(delta) utilise un décalage exprimé en nombre d’entrées dans l’historique de session. Web IDL convertit d’abord l’argument fourni en entier signé sur 32 bits (long). Un résultat négatif demande de reculer, un résultat positif d’avancer. Si le résultat est zéro ou si l’argument est omis, la page est rechargée. Le parcours est asynchrone.
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.go();
history.go(delta);history.go(delta) est une API Web du navigateur définie par HTML, et non une fonction ECMAScript. Web IDL convertit delta en entier signé sur 32 bits (long). Le décalage obtenu indique la direction et le nombre d’étapes. Par exemple, 4294967295 devient -1 après conversion : history.go(4294967295) demande donc de reculer d’une entrée. history.go(-1) correspond à history.back(), et history.go(1) à history.forward(). Un décalage hors limites ne fait rien ; history.go(0) et history.go() rechargent la page.
La méthode renvoie undefined, et non une Promise. Le parcours est asynchrone : le code qui suit l’appel ne doit pas supposer que l’entrée de destination est déjà active. Le parcours peut rester dans le même document ou en ouvrir un autre. Pour le parcours illustré entre des entrées créées par pushState(), lisez l’état dans popstate.
L’historique est constitué d’entrées de session, et pas seulement de chargements de pages distincts ; des cadres peuvent aussi y participer. Un document qui n’est pas pleinement actif provoque une SecurityError ; des restrictions de navigation peuvent bloquer l’opération. Les moteurs de navigateur actuels prennent en charge cette API, mais la présence de Node.js ne prouve pas qu’elle y soit disponible.
L’exemple crée deux entrées dans le même document, puis revient à la première. Exécutez-le sur une page de test temporaire : il modifie l’historique et supprime toute branche de navigation avant existante.
Exemples
const button = document.createElement('button');
button.textContent = 'Run history demo';
document.body.append(button);
button.addEventListener('click', () => {
button.disabled = true;
history.pushState({ demoStep: 1 }, '');
history.pushState({ demoStep: 2 }, '');
window.addEventListener('popstate', (event) => {
console.log(`step=${event.state.demoStep}`);
}, { once: true });
history.go(-1);
}, { once: true });Résultat
step=1
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.