Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

history.back() — cofanie w historii sesji

history.back() żąda przejścia o jeden wpis wstecz w historii sesji przeglądarki. Działa jak history.go(-1); bez poprzedniego wpisu nic 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.back()

history.back() nie przyjmuje argumentów i zwraca undefined, a nie Promise. Przejście jest asynchroniczne: następna instrukcja nie oznacza jego zakończenia. Poprzedni wpis może dotyczyć tego samego dokumentu lub innej witryny.

To API przeglądarki z HTML Standard, nie funkcja ECMAScript. Jest obsługiwane we współczesnych silnikach przeglądarek; obecność Node 24 w projekcie nie potwierdza dostępności tego API. Wywołanie dla dokumentu, który nie jest w pełni aktywny, zgłasza SecurityError. Przeglądarka może też zablokować operację.

W przykładzie pushState() tworzy dwa wpisy bez przeładowania. Po cofnięciu popstate udostępnia stan docelowego wpisu. Nie odczytuj wyniku przejścia natychmiast po history.back().

Przykłady

const button = document.createElement('button');
button.textContent = 'Run history.back()';
document.body.append(button);

button.addEventListener('click', () => {
  button.disabled = true;
  history.pushState({ demoStep: 1 }, '');
  history.pushState({ demoStep: 2 }, '');

  window.addEventListener('popstate', (event) => {
    console.log(`demoStep: ${event.state.demoStep}`);
    button.remove();
  }, { once: true });

  history.back();
}, { once: true });

Wynik

demoStep: 1

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

Źródła