Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori