Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

history.go() — procházení historie relace

history.go(delta) používá posun vyjádřený počtem položek historie relace. Web IDL nejprve převede zadaný argument na 32bitové celé číslo se znaménkem (long). Záporný výsledek znamená požadavek na přechod zpět, kladný na přechod vpřed. Pokud je výsledek nula nebo je argument vynechán, stránka se znovu načte. Procházení je asynchronní.

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

Syntaxe

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

history.go(delta) je webové API prohlížeče definované standardem HTML, nikoli funkce ECMAScriptu. Web IDL převede delta na 32bitové celé číslo se znaménkem (long). Výsledný posun určuje směr a počet kroků. Například 4294967295 se převede na -1, takže history.go(4294967295) požaduje přechod o jednu položku zpět. history.go(-1) odpovídá history.back() a history.go(1) odpovídá history.forward(). Posun mimo rozsah nic neudělá; history.go(0) a history.go() znovu načtou stránku.

Metoda vrací undefined, nikoli Promise. Procházení je asynchronní: kód následující po volání nesmí předpokládat, že cílová položka už je aktivní. Procházení může zůstat ve stejném dokumentu nebo přejít do jiného. U znázorněného přechodu mezi položkami vytvořenými pomocí pushState() přečtěte stav v události popstate.

Historii tvoří položky relace, nikoli jen samostatná načtení stránek; účastnit se jí mohou také rámce. Dokument, který není plně aktivní, vyvolá SecurityError; navigaci mohou zablokovat omezení. Současné prohlížečové jádra toto API podporují, přítomnost Node.js však nedokládá jeho dostupnost.

Příklad vytvoří dvě položky v rámci stejného dokumentu a potom se vrátí k první. Spusťte jej na jednorázové testovací stránce: změní historii a odstraní případnou existující větev historie vpřed.

Pří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ýsledek

step=1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje