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.