CKTIS / JavaScript
history.forward() — vooruitgaan in de geschiedenis
history.forward() gaat één item vooruit in de sessiegeschiedenis van de browser. De methode werkt als history.go(1); zonder volgend item verandert er niets.
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.forward()history.forward() accepteert geen argumenten en retourneert undefined, geen Promise. De methode werkt als history.go(1): ze vraagt om naar het volgende item in de sessiegeschiedenis te gaan. Dat item kan bij hetzelfde document of een andere pagina horen; de methode maakt geen item aan.
De verplaatsing is asynchroon. Lees de nieuwe history.state niet meteen na de aanroep. In het voorbeeld synchroniseren popstate-gebeurtenissen de verplaatsing tussen items van hetzelfde document. pushState() activeert zelf geen popstate.
Als er geen volgend item is, gebeurt er niets. Een document dat niet volledig actief is, veroorzaakt een SecurityError; de browser kan het navigatieverzoek ook blokkeren. Dit is een browser-API die in HTML is gedefinieerd, geen ECMAScript-functie; de aanwezigheid van Node 24 bewijst niet dat de API wordt ondersteund. De standaard geeft aan dat alle huidige browser-engines ondersteuning bieden.
Voorbeelden
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 });Resultaat
1 2
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.