Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

history.go() — prechádzanie histórie relácie

history.go(delta) používa posun vyjadrený počtom položiek histórie relácie. Web IDL najprv skonvertuje zadaný argument na 32-bitové celé číslo so znamienkom (long). Záporný výsledok znamená požiadavku na prechod späť, kladný na prechod dopredu. Ak je výsledok nula alebo je argument vynechaný, stránka sa znova načíta. Prechod je asynchrónny.

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

Syntax

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

history.go(delta) je webové API prehliadača definované štandardom HTML, nie funkcia ECMAScriptu. Web IDL skonvertuje delta na 32-bitové celé číslo so znamienkom (long). Výsledný posun určuje smer a počet krokov. Napríklad 4294967295 sa skonvertuje na -1, takže history.go(4294967295) vyžiada prechod o jednu položku späť. history.go(-1) zodpovedá history.back() a history.go(1) zodpovedá history.forward(). Posun mimo rozsahu nič neurobí; history.go(0) a history.go() znova načítajú stránku.

Metóda vracia undefined, nie Promise. Prechod je asynchrónny: kód po volaní nesmie predpokladať, že cieľová položka už je aktívna. Prechod môže zostať v tom istom dokumente alebo prejsť do iného. Pri znázornenom prechode medzi položkami vytvorenými pomocou pushState() prečítajte stav v udalosti popstate.

Históriu tvoria položky relácie, nielen samostatné načítania stránok; zúčastňovať sa na nej môžu aj rámce. Dokument, ktorý nie je úplne aktívny, vyvolá SecurityError; navigáciu môžu blokovať obmedzenia. Súčasné prehliadačové jadrá toto API podporujú, prítomnosť Node.js však nedokazuje jeho dostupnosť.

Príklad vytvorí dve položky v tom istom dokumente a potom sa vráti k prvej. Spustite ho na jednorazovej testovacej stránke: zmení históriu a odstráni prípadnú existujúcu vetvu histórie dopredu.

Príklady

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

Výsledok

step=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje