CKTIS / JavaScript
history.forward() — in der Chronik vorwärtsgehen
history.forward() wechselt in der Sitzungschronik des Browsers einen Eintrag weiter. Die Methode verhält sich wie history.go(1); gibt es keinen nächsten Eintrag, ändert sich nichts.
Version: 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() nimmt keine Argumente entgegen und gibt undefined zurück, nicht ein Promise. Die Methode verhält sich wie history.go(1): Sie fordert den Wechsel zum nächsten Eintrag der Sitzungschronik an. Dieser Eintrag kann zum selben Dokument oder zu einer anderen Seite gehören; die Methode erstellt keinen neuen Eintrag.
Der Wechsel erfolgt asynchron. Lies den neuen Wert von history.state nicht unmittelbar nach dem Aufruf aus. Im Beispiel synchronisieren popstate-Ereignisse den Wechsel zwischen Einträgen desselben Dokuments. pushState() selbst löst kein popstate aus.
Gibt es keinen nächsten Eintrag, geschieht nichts. Bei einem Dokument, das nicht vollständig aktiv ist, wird ein SecurityError ausgelöst; außerdem kann der Browser die Navigationsanfrage blockieren. Dies ist eine Browser-API, die in HTML definiert ist, keine ECMAScript-Funktion; das Vorhandensein von Node 24 belegt nicht, dass sie unterstützt wird. Der Standard weist auf Unterstützung in allen aktuellen Browser-Engines hin.
Beispiele
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 });Ergebnis
1 2
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.