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.