Содержит массив информации о URL, которые были посещены пользователем в данном окне. Эта информация хранится в списке history и может быть получена через меню Go браузера.
JavaScript 1.1: добавлены свойства |
Объекты History
являются предопределёнными объектами JavaScript, доступ к
которым Вы можете получить через свойство history
объекта window
.
Для изменения текущего URL окна без генерации вхождения в history Вы можете
использовать метод
Location.replace
. При этом
текущая страница замещается другой без генерации вхождения в history. См.
Location.replace
.
Вы можете обратиться ко вхождениям в history через использование массива
window.history
. Этот массив
содержит вхождение для каждого вхождения в history в порядке исходного кода.
Каждое вхождение массива является строкой, содержащей URL.
Например, если список history содержит три именованных вхождения, эти
вхождения отражаются как history[0]
, history[1]
и history[2]
.
Если Вы получаете доступ к массиву history
без специфицирования элемента массива, браузер возвращает строку HTML, которая
выводит таблицу URLs, каждый из которых является ссылкой.
Свойство | Описание |
---|---|
| |
| |
| |
|
Метод | Описание |
---|---|
| |
| |
|
Кроме того, этот объект наследует методы
watch
и
unwatch
из объекта
Object
.
Пример 1. Здесь выполняется переход к URL , который был посещён пользователем в текущем окне на три шага назад.
history.go(-3)
Пример 2.
Вы можете использовать объект history
со специфицированным окном
или фрэймом. В данном примере window2
переходит назад на одну
ступень назад в истории данного окна (или сессии):
window2.history.back()
Пример 3. В этом примере второй фрэйм в наборе фрэйма переходит назад на один элемент:
parent.frames[1].history.back()
Пример 4. В этом примере фрэйм frame1
набора фрэймов
переходит назад на один шаг:
parent.frame1.history.back()
Пример 5. В этом примере фрэйм
frame2
в окне window2
переходит назад на один шаг:
window2.frame2.history.back()
Пример 6. Этот код определяет, содержит ли первое вхождение массива history
строку "NETSCAPE"
. Если это так, вызывается функция myFunction
.
if (history[0].indexOf("NETSCAPE") != -1) {
myFunction(history[0])
}
Пример 7. Здесь отображается весь список history:
document.writeln("<B>history is</B> " + history)
Этот код отобразит примерно такое:
history is
Welcome to Netscape http://home.netscape.com/
Sun Microsystems http://www.sun.com/
Royal Airways http://www.supernet.net/~dugbrown/
Location
,
Location.replace
Загружает предыдущий URL из списка history.
back()
Этот метод выполняет такую же акцию, что и пользователь, нажимая кнопку Back в браузере.
Метод back
это то же, что и history.go(-1)
.
Следующие кнопки выполняют ту же операцию, что и кнопка Back браузера:
<P><INPUT TYPE="button" VALUE="< Go Back"
onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
onClick="myWindow.back()">
History.forward
, History.go
Строка, специфицирующая полный URL текущего вхождения из списка history.
Получение значения этого свойства требует привилегии UniversalBrowserRead
.
Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу
JavaScript 1.1. Это свойство
разрушено/запорчено по умолчанию.
Значение отсутствует, если разрушение данных отключено. О разрушении данных см.
книгу
Здесь определяется, содержит ли
history.current
строку "netscape.com"
. Если это так, вызывается функция myFunction
.
if (history.current.indexOf("netscape.com") != -1) {
myFunction(history.current)
}
History.next
, History.previous
Загружает следующий URL из списка history.
forward()
Этот метод выполняет такое же действие, что и пользователь, нажимающий кнопку Forward в браузере.
Метод forward
это то же, что и history.go(1)
.
Следующие кнопки выполняют ту же операцию, что и кнопка Forward браузера:
<P><INPUT TYPE="button" VALUE="< Forward"
onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Forward"
onClick="myWindow.forward()">
History.back
, History.go
Загружает URL из списка history.
go(delta)
go(location)
delta | |
location |
Метод go
переходит к точке списка history, определённой
специфицированным параметром.
Если аргумент delta
равен 0, браузер
перезагружает текущую страницу. Если целое число больше 0, метод go
загружает URL, находящийся на специфицированное число вхождений впереди в списке history;
иначе (если меньше 0) он загружает URL, находящийся на специфицированное число
вхождений назад в списке history.
Аргумент location
это строка. Используйте location
для
загрузки ближайшего вхождения из
history, чей URL содержит location
в качестве подстроки. Совпадение URL
с параметром location
делается с учётом регистра. Каждый раздел URL
содержит свою информацию. См. в Location
описание компонентов URL.
Метод go
создаёт новое вхождение в списке history. Для загрузки URL без создания
вхождения в списке history используйте Location.replace
.
Эта кнопка делает
переход к ближайшему вхождению из history, которое содержит строку "home.netscape.com"
:
<P><INPUT TYPE="button" VALUE="Go"
onClick="history.go('home.netscape.com')">
Следующая кнопка переходит к URL, который находится на три шага назад в списке history:
<P><INPUT TYPE="button" VALUE="Go"
onClick="history.go(-3)">
History.back
, History.forward
,
Location.reload
,
Location.replace
Количество элементов в массиве history
.
Получение значения этого свойства требует привилегии UniversalBrowserRead
.
О безопасности см. книгу
Строка, специфицирующая полный URL следующего вхождения из history.
Получение значения этого свойства требует привилегии UniversalBrowserRead
.
Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу
JavaScript 1.1. Это свойство
разрушено/запорчено по умолчанию.
Значение отсутствует, если разрушение данных отключено. О разрушении данных см.
книгу
Свойство next
отражает URL, который должен использоваться, если выбрано меню Forward из Go.
Здесь определяется, содержит ли history.next
строку
"NETSCAPE.COM"
. Если да - вызывается функция myFunction
.
if (history.next.indexOf("NETSCAPE.COM") != -1) {
myFunction(history.next)
}
History.current
, History.previous
Строка, специфицирующая полный URL предыдущего вхождения из history.
Получение значения этого свойства требует привилегии UniversalBrowserRead
.
Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу
JavaScript 1.1.
Это свойство разрушено/запорчено по умолчанию.
Значение отсутствует, если разрушение данных отключены. О разрушении данных см. книгу
Свойство previous
отражает URL, который должен использоваться при выборе меню Back из Go.
Здесь определяется, содержит ли history.previous
строку
"NETSCAPE.COM"
. Если да - вызывается функция myFunction
.
if (history.previous.indexOf("NETSCAPE.COM") != -1) {
myFunction(history.previous)
}
History.current
, History.next
Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999