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

CKTIS / JavaScript

history.forward() — posun vpřed v historii

history.forward() posune historii relace prohlížeče o jednu položku vpřed. Chová se jako history.go(1); pokud další položka neexistuje, nic nezmění.

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.forward()

history.forward() nepřijímá žádné argumenty a vrací undefined, nikoli Promise. Chová se jako history.go(1): požádá o přechod na další položku historie relace. Tato položka může patřit stejnému dokumentu nebo jiné stránce; metoda novou položku nevytváří.

Přechod je asynchronní. Novou hodnotu history.state nečtěte bezprostředně po zavolání metody. V příkladu události popstate synchronizují přechod mezi položkami stejného dokumentu. Samotné pushState() událost popstate nevyvolá.

Pokud další položka neexistuje, nic se nestane. Dokument, který není plně aktivní, způsobí chybu SecurityError; prohlížeč může požadavek na navigaci také zablokovat. Jde o API prohlížeče definované standardem HTML, nikoli o funkci ECMAScriptu; samotná přítomnost Node 24 nedokládá podporu. Standard uvádí podporu ve všech současných jádrech prohlížečů.

Příklady

const button = document.createElement('button');
button.textContent = 'Run history demo';
document.body.append(button);

button.addEventListener('click', () => {
  button.disabled = true;
  history.pushState({ step: 1 }, '');
  history.pushState({ step: 2 }, '');

  window.addEventListener('popstate', () => {
    console.log(history.state.step);
    window.addEventListener('popstate', () => {
      console.log(history.state.step);
      button.remove();
    }, { once: true });
    history.forward();
  }, { once: true });

  history.back();
}, { once: true });

Výsledek

1
2

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