History.go()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Метод History.go() выполняет переход на определённую страницу в истории текущей сессии. С его помощью можно перемещаться как вперёд, так и назад, в зависимости от значения параметра.

Данный метод является асинхронным. Добавьте обработчик для события popstate, чтобы определить, когда переход закончен.

Синтаксис

history.go([delta])

Параметры

delta Необязательный

Относительное положение в истории, куда вы хотите переместиться. Отрицательные значения перемещают назад, а положительные — вперёд. Например, history.go(2) перемещает вперёд на 2 страницы, а history.go(-2) перемещает на 2 страницы назад. Если метод вызван без параметра или же delta равна 0, результат выполнения будет такой же, как у location.reload().

Примеры

Перемещение на 1 страницу назад (аналог вызова back()):

js
history.go(-1);

Перемещение на страницу вперёд, как forward():

js
history.go(1);

Перемещение на 2 страницы вперёд:

js
history.go(2);

Перемещение на 2 страницы назад:

js
history.go(-2);

Также, оба этих вызова перезагрузят страницу:

js
history.go();
history.go(0);

Спецификации

Specification
HTML Standard
# dom-history-go-dev

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также