Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

history.go() — premikanje po zgodovini seje

history.go(delta) uporablja odmik, izražen v številu vnosov v zgodovini seje. Web IDL podani argument najprej pretvori v 32-bitno predznačeno celo število (long). Negativen rezultat zahteva premik nazaj, pozitiven pa premik naprej. Če je rezultat nič ali je argument izpuščen, se stran znova naloži. Premik je asinhron.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

history.go();
history.go(delta);

history.go(delta) je spletni API brskalnika, opredeljen v HTML, in ne funkcija ECMAScript. Web IDL pretvori delta v 32-bitno predznačeno celo število (long). Tako dobljeni odmik določa smer in število korakov. Na primer, 4294967295 se pretvori v -1, zato history.go(4294967295) zahteva premik za en vnos nazaj. history.go(-1) ustreza history.back(), history.go(1) pa history.forward(). Odmik zunaj obsega ne naredi ničesar; history.go(0) in history.go() znova naložita stran.

Metoda vrne undefined, ne Promise. Premik je asinhron: koda po klicu ne sme predpostavljati, da je ciljni vnos že aktiven. Premik lahko ostane v istem dokumentu ali preide v drugega. Pri prikazanem premiku med vnosi, ustvarjenimi z pushState(), preberite stanje v dogodku popstate.

Zgodovino seje sestavljajo vnosi, ki ne nastanejo le ob ločenih nalaganjih strani; v zgodovini lahko sodelujejo tudi okvirji. Dokument, ki ni v celoti aktiven, povzroči SecurityError; omejitve navigacije lahko operacijo blokirajo. Trenutni brskalniški pogoni podpirajo ta API, vendar prisotnost Node.js ne dokazuje njegove razpoložljivosti.

Primer ustvari dva vnosa v istem dokumentu in se nato vrne na prvega. Zaženite ga na začasni testni strani: spremeni zgodovino in zavrže morebitno obstoječo vejo zgodovine za naprej.

Primeri

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

Rezultat

step=1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri