CKTIS / JavaScript
history.go() — de sessiegeschiedenis doorlopen
history.go(delta) gebruikt een verschuiving uitgedrukt in items van de sessiegeschiedenis. Web IDL zet een opgegeven argument eerst om in een 32-bits geheel getal met teken (long). Een negatieve uitkomst vraagt om achteruit te gaan, een positieve om vooruit te gaan. Bij nul of een weggelaten argument wordt de pagina opnieuw geladen. De navigatie verloopt asynchroon.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
history.go();
history.go(delta);history.go(delta) is een browser-Web-API die is gedefinieerd door HTML, geen ECMAScript-functie. Web IDL zet delta om in een 32-bits geheel getal met teken (long). De resulterende verschuiving geeft de richting en het aantal stappen aan. Zo wordt 4294967295 omgezet in -1, waardoor history.go(4294967295) vraagt om één item terug te gaan. history.go(-1) komt overeen met history.back() en history.go(1) met history.forward(). Een verschuiving buiten het bereik doet niets; history.go(0) en history.go() laden de pagina opnieuw.
De methode retourneert undefined, geen Promise. Het doorlopen gebeurt asynchroon: code na de aanroep mag er niet van uitgaan dat het doelitem al actief is. Het doorlopen kan binnen hetzelfde document blijven of naar een ander document gaan. Lees voor het getoonde doorlopen tussen items die met pushState() zijn gemaakt de status uit in popstate.
De geschiedenis bestaat uit sessie-items, niet alleen uit afzonderlijke paginaladingen; ook frames kunnen eraan deelnemen. Een document dat niet volledig actief is, veroorzaakt SecurityError; navigatiebeperkingen kunnen de bewerking blokkeren. Huidige browser-engines ondersteunen deze API, maar de aanwezigheid van Node.js bewijst niet dat de API daar beschikbaar is.
Het voorbeeld maakt twee items in hetzelfde document en gaat daarna terug naar het eerste. Voer het uit op een wegwerp-testpagina: het wijzigt de geschiedenis en verwijdert een eventuele bestaande voorwaartse geschiedenisvertakking.
Voorbeelden
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 });Resultaat
step=1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.