История: метод go()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

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

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

Синтаксис

go()
go(delta)

Параметры

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

Возвращаемое значение

None (undefined).

Исключения

SecurityError DOMException: Выбрасывается, если связанный документ не полностью активен. Браузеры также ограничивают навигации и могут выбросить эту ошибку, вывести предупреждение или проигнорировать вызов, если он вызван слишком часто.

Примеры

Для перемещения назад на одну страницу (что эквивалентно вызову back()):

history.go(-1);

Для перехода вперёд на одну страницу, как при вызове forward():

history.go(1);

Для перехода вперёд на две страницы:

history.go(2);

Для перехода назад на две страницы:

history.go(-2);

И наконец, любое из следующих утверждений перезагрузит текущую страницу:

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

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

Спецификация
HTML # dom-history-go-dev

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

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`go`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/History/go