CKTIS / JavaScript
history.forward() — przejście naprzód w historii
history.forward() przechodzi o jeden wpis naprzód w historii sesji przeglądarki. Działa jak history.go(1); bez następnego wpisu niczego nie zmienia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
history.forward()history.forward() nie przyjmuje argumentów i zwraca undefined, nie Promise. Działa tak samo jak history.go(1): żąda przejścia do następnego wpisu historii sesji. Wpis może dotyczyć tego samego dokumentu lub innej strony; metoda nie tworzy nowego wpisu.
Przejście jest asynchroniczne. Nie odczytuj nowego history.state bezpośrednio po wywołaniu. W przykładzie zdarzenia popstate synchronizują przejścia między wpisami tego samego dokumentu. pushState() samo nie wywołuje popstate.
Brak następnego wpisu oznacza brak działania. Dokument, który nie jest w pełni aktywny, powoduje SecurityError; przeglądarka może też zablokować żądanie nawigacji. To przeglądarkowe API standardu HTML, nie funkcja ECMAScript; obecność Node 24 nie potwierdza jego obsługi. Standard wskazuje obsługę we wszystkich bieżących silnikach przeglądarek.
Przykłady
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 });Wynik
1 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.