Объект history

106
посл. ред. 25.05.2016

Объект window.history позволяет управлять сессией браузера (переходить по страницам из истории) во вкладке или фрейме, в котором загружена текущая страница.

С помощью объекта history можно осуществлять навигацию по истории браузера, но получить данные о страницах (например, URL) не получится.

Свойства объекта history

history.length

Содержит общее количество страниц в сессии. Текущая страница тоже включается в данное свойство.

<script>
  alert(history.length); /* при открытии в новой вкладке выведет 1 */
</script>

Методы объекта history

history.go()
Загружает из истории страницу, определяемую относительно положения текущей страницы. Для этого аргументом указывается целое число, определяющее величину прыжка по журналу истории. Положительное число говорит о том, что необходимо перейти вперёд по истории, отрицательное - назад. Например, history.go(-2) приведёт к переходу на две страницы назад по истории.
Данный метод не сработает, если:
  • прыжок происходит за пределы журнала истории.
  • аргумент не указан.
  • аргумент не является целым числом.
history.back()
Отправляет на предыдущую страницу аналогично нажатию на кнопку Назад в браузере. Равноценно вызову history.go(-1). Если текущая страница является первой в журнале истории, то ничего не происходит.
history.forward()
Отправляет на следующую страницу аналогично нажатию на кнопку Вперёд в браузере. Равноценно вызову history.go(1). Если текущая страница является последней в журнале истории, то ничего не происходит.