История

package js.html

Доступно в js

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

Документация История от Авторов Mozilla, лицензирована по CC-BY-SA 2.5.

См. также:

• https://developer.mozilla.org/en-US/docs/Web/API/History

Переменные

read onlylength:Int

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

scrollRestoration:ScrollRestoration

Позволяет веб-приложениям явно установить поведение по умолчанию для восстановления прокрутки при переходе по истории. Это свойство может быть auto или manual.

read onlystate:Dynamic

Возвращает значение any, представляющее состояние в верхней части стека истории. Это способ посмотреть состояние без ожидания события popstate.

Методы

back():Void

Переходит к предыдущей странице в истории сеанса, то же действие, что при нажатии пользователем кнопки «Назад» в браузере. Эквивалентно history.go(-1). Вызов этого метода для возврата к странице, расположенной раньше первой в истории сеанса, не имеет эффекта и не вызывает исключение.

	@throws DOMError

forward():Void

Переходит к следующей странице в истории сеанса, то же действие, что при нажатии пользователем кнопки «Вперед» в браузере; это эквивалентно history.go(1). Вызов этого метода для перехода вперед за пределы последней страницы в истории сеанса не имеет эффекта и не вызывает исключение.

	@throws DOMError

go(delta:Int = 0):Void

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

Исключения:

pushState(data:Dynamic, title:String, ?url:String):Void

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

Исключения:

replaceState(data:Dynamic, title:String, ?url:String):Void

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

Исключения: