CKTIS / JavaScript
history.forward() — posun vpred v histórii
history.forward() posunie históriu relácie prehliadača o jednu položku vpred. Správa sa ako history.go(1); ak ďalšia položka neexistuje, nič nezmení.
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.forward()history.forward() neprijíma žiadne argumenty a vracia undefined, nie Promise. Správa sa ako history.go(1): požiada o prechod na ďalšiu položku histórie relácie. Táto položka môže patriť tomu istému dokumentu alebo inej stránke; metóda nevytvára novú položku.
Prechod je asynchrónny. Novú hodnotu history.state nečítajte bezprostredne po zavolaní metódy. V príklade udalosti popstate synchronizujú prechod medzi položkami toho istého dokumentu. Samotné pushState() udalosť popstate nevyvolá.
Ak ďalšia položka neexistuje, nič sa nestane. Dokument, ktorý nie je úplne aktívny, spôsobí chybu SecurityError; prehliadač môže požiadavku na navigáciu aj zablokovať. Ide o API prehliadača definované štandardom HTML, nie o funkciu ECMAScriptu; samotná prítomnosť Node 24 nedokazuje podporu. Štandard uvádza podporu vo všetkých súčasných jadrách prehliadačov.
Prí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ýsledok
1 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.