База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

history.forward() — придвижване напред в историята

history.forward() преминава с един запис напред в историята на сесията на браузъра. Работи като history.go(1); ако няма следващ запис, нищо не се променя.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

history.forward()

history.forward() не приема аргументи и връща undefined, а не Promise. Работи като history.go(1): заявява преминаване към следващия запис в историята на сесията. Този запис може да се отнася за същия документ или за друга страница; методът не създава нов запис.

Преминаването е асинхронно. Не четете новата стойност на history.state непосредствено след извикването. В примера събитията popstate синхронизират преминаването между записи на същия документ. Самото pushState() не задейства popstate.

Ако няма следващ запис, нищо не се случва. Документ, който не е напълно активен, причинява SecurityError; браузърът може също да блокира заявката за навигация. Това е API на браузъра, дефинирано в HTML, а не функция на ECMAScript; наличието на Node 24 не доказва поддръжка. Стандартът посочва поддръжка във всички текущи браузърни енджини.

Примери

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

Резултат

1
2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници