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.