CKTIS / JavaScript
history.go() — kretanje kroz povijest sesije
history.go(delta) koristi pomak izražen brojem unosa u povijesti sesije. Web IDL najprije pretvara zadani argument u 32-bitni cijeli broj s predznakom (long). Negativan rezultat traži pomak unatrag, a pozitivan pomak unaprijed. Ako je rezultat nula ili je argument izostavljen, stranica se ponovno učitava. Kretanje je asinkrono.
Verzija: 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) web je API preglednika definiran u HTML-u, a ne funkcija ECMAScripta. Web IDL pretvara delta u 32-bitni cijeli broj s predznakom (long). Dobiveni pomak određuje smjer i broj koraka. Primjerice, 4294967295 pretvara se u -1, pa history.go(4294967295) traži pomak za jedan unos unatrag. history.go(-1) odgovara pozivu history.back(), a history.go(1) pozivu history.forward(). Pomak izvan raspona ne čini ništa; history.go(0) i history.go() ponovno učitavaju stranicu.
Metoda vraća undefined, a ne Promise. Kretanje je asinkrono: kod nakon poziva ne smije pretpostaviti da je ciljni unos već aktivan. Kretanje može ostati u istom dokumentu ili prijeći u drugi. Za prikazano kretanje između unosa stvorenih pomoću pushState() pročitajte stanje u događaju popstate.
Povijest se sastoji od unosa sesije, a ne samo od zasebnih učitavanja stranica; mogu sudjelovati i okviri. Dokument koji nije potpuno aktivan uzrokuje SecurityError; ograničenja navigacije mogu blokirati operaciju. Današnji preglednički enginei podržavaju ovaj API, ali prisutnost Node.js-a ne dokazuje njegovu dostupnost.
Primjer stvara dva unosa u istom dokumentu, a zatim se vraća na prvi. Pokrenite ga na privremenoj testnoj stranici: mijenja povijest i odbacuje postojeću granu povijesti prema naprijed, ako postoji.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.