Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła