History

History интерфейс позволяет манипулировать историей браузера в пределах сессии, а именно историей о посещённых страницах в пределах вкладки или фрейма загруженного внутри страницы.

Свойства

History интерфейс не наследует никакие родительские свойства.

History.length Только для чтения

Возвращает целочисленное значение типа Integer, которое характеризует собой количество записей в истории сессии, включая текущую загруженную страницу. Для примера, история новой вкладки с загруженной страницей равна 1.

History.current Только для чтения Non-standard

Возвращает DOMString, представляющий собой активный URL элемент в истории сессии. Это свойство никогда не было доступно для веб-контента и более не поддерживается никакими браузерами. Используйте location.href (en-US) вместо него.

History.next Только для чтения Non-standard

Возвращает DOMString, представляющий собой следующий URL элемент в истории сессии. Это свойство никогда не было доступно для веб-контента и более не поддерживается другими браузерами.

History.previous Только для чтения Non-standard

Возвращает DOMString, представляющий собой предыдущий URL элемент в истории сессии. Это свойство никогда не было доступно для веб-контента и более не поддерживается другими браузерами.

History.state Только для чтения

Возвращает какое-либо значение, представляющее собой состояние в вершине истории стека. Это способ посмотреть на состояние без ожидания popstate (en-US) события.

Методы

History интерфейс не наследует никаких родительских методов.

History.back() (en-US)

Делает вызов предыдущей страницы из истории, если она существует. Эквивалент метода history.go(-1).

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

History.forward() (en-US)

Переход к следующей странице в истории сессии, то же самое действие, как и при нажатии пользователем кнопки Forward в браузере. Эквивалентно history.go(1).

Примечание: Вызов этого метода, чтобы перейти к последней странице в истории сессии не имеет никакого эффекта и не вызывает исключений.

History.go()

Загружает страницу из истории сессии, определяя её положение относительно текущей страницы, например: -1 для предыдущей страницы или 1 для следующей страницы. Когда integerDelta выходит за предел (например, -1, когда нет ранее посещённых страниц в истории сессии), метод не делает ничего, и не вызывает исключение. Вызов Go () без параметров или с не целочисленным аргументом не имеет никакого эффекта (в отличие от Internet Explorer, который поддерживает строки URL в качестве аргумента).

History.pushState()

Помещает полученные данные в стек истории сессии с определённым заголовком и, при наличии , URL. Данные рассматриваются DOM как непрозрачные; вы можете задать любой объект JavaScript, который может быть сериализован. Обратите внимание, что в настоящее время Firefox игнорирует параметр заголовка; для получения дополнительной информации см. управление историей браузера.

Примечание: В Gecko 2.0 до Gecko 5.0, передаваемый объект сериарилизовался в JSON. Начиная с Gecko 6.0, объект обрабатывается по алгоритму структурированного клонирования. Он позволяет передавать более широкое разнообразие объектов.

History.replaceState()

Обновляет последнюю запись в стеке истории содержащий определённые данные, заголовок и, при наличии, URL. Данные рассматриваются DOM как непрозрачные; вы можете задать любой объект JavaScript, который может быть сериализован. Обратите внимание, что в настоящее время Firefox игнорирует параметр заголовка; для получения дополнительной информации см.управление историей браузера.

Примечание: В Gecko 2.0 до Gecko 5.0, передаваемый объект сериарилизовался в JSON. Начиная с Gecko 6.0, объект обрабатывается по алгоритму структурированного клонирования. Он позволяет передавать более широкое разнообразие объектов.

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

Specification
HTML Standard
# the-history-interface

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

BCD tables only load in the browser

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

  • window.history свойство, возвращающее историю текущей сессии.