Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

history.go() — przechodzenie po historii sesji

history.go(delta) używa przesunięcia wyrażonego w liczbie wpisów historii sesji. Web IDL najpierw konwertuje podany argument na 32-bitową liczbę całkowitą ze znakiem (long). Ujemny wynik oznacza przejście wstecz, dodatni — przejście do przodu, a zero lub pominięcie argumentu — przeładowanie strony. Przejście jest asynchroniczne.

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.go();
history.go(delta);

history.go(delta) to przeglądarkowe Web API zdefiniowane w HTML, nie funkcja ECMAScript. Kierunek i liczbę kroków określa przesunięcie uzyskane po konwersji delta przez Web IDL na 32-bitową liczbę całkowitą ze znakiem (long). Na przykład 4294967295 po konwersji daje -1, więc history.go(4294967295) żąda przejścia o jeden wpis wstecz. history.go(-1) odpowiada history.back(), a history.go(1) — history.forward(). Przesunięcie poza zakres nic nie robi; history.go(0) i history.go() przeładowują stronę.

Metoda zwraca undefined, nie Promise. Przejście jest asynchroniczne: kod po wywołaniu nie powinien zakładać, że docelowy wpis jest już aktywny. Może ono pozostać w tym samym dokumencie albo przejść do innego. Dla pokazanego przejścia między wpisami utworzonymi przez pushState() odczytaj stan w popstate.

Historia obejmuje wpisy sesji, nie tylko odrębne załadowania stron; mogą w niej uczestniczyć także ramki. Dokument, który nie jest w pełni aktywny, powoduje SecurityError; ograniczenia nawigacji mogą zablokować operację. API jest obsługiwane przez bieżące silniki przeglądarek, ale obecność Node.js nie dowodzi jego dostępności.

Przykład tworzy dwa wpisy tego samego dokumentu, a następnie cofa do pierwszego. Uruchom go na jednorazowej stronie testowej: zmienia historię i usuwa istniejącą gałąź historii do przodu.

Przykłady

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 });

Wynik

step=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła