Книги-online

History Оглавление | Назад | Вперёд | Индекс

History

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

Клиентский объект

Реализовано в

JavaScript 1.0

JavaScript 1.1: добавлены свойства current, next и previous.

Создание

Объекты 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, каждый из которых является ссылкой.

Свойства. Резюме.

Свойство	Описание
current	Специфицирует URL текущего вхождения в history.
length	Отражает количество вхождений в списке history.
next	Специфицирует URL следующего вхождения в history.
previous	Специфицирует URL предыдущего вхождения в history.

Методы. Резюме.

Метод	Описание
back	Загружает предыдущий URL из списка history.
forward	Загружает следующий URL из списка history.
go	Загружает URL из списка history.

Кроме того, этот объект наследует методы 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

back

Загружает предыдущий URL из списка history.

Метод из	History
Реализован в	JavaScript 1.0

Синтаксис

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

current

Строка, специфицирующая полный URL текущего вхождения из списка history.

Свойство из	History
Только для чтения
Реализовано в	JavaScript 1.1

Безопасность

Получение значения этого свойства требует привилегии UniversalBrowserRead. Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу Клиентский JavaScript. Руководство.

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. Значение отсутствует, если разрушение данных отключено. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Пример

Здесь определяется, содержит ли history.current строку "netscape.com". Если это так, вызывается функция myFunction.

if (history.current.indexOf("netscape.com") != -1) {
   myFunction(history.current)
}

См. также

History.next, History.previous

forward

Загружает следующий URL из списка history.

Метод из	History
Реализован в	JavaScript 1.0

Синтаксис

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

go

Загружает URL из списка history.

Метод из	History
Реализован в	JavaScript 1.0

Синтаксис

go(delta)
go(location)

Параметры

delta	Целое число - относительная позиция в списке history.
location	Строка, представляющая все или часть URL из списка history.

Описание

Метод 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

length

Количество элементов в массиве history.

Свойство из	History
Только для чтения
Реализовано в	JavaScript 1.0

Безопасность

Получение значения этого свойства требует привилегии UniversalBrowserRead. О безопасности см. книгу Клиентский JavaScript. Руководство.

Строка, специфицирующая полный URL следующего вхождения из history.

Свойство из	History
Только для чтения
Реализовано в	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.

Свойство из	History
Только для чтения
Реализовано в	JavaScript 1.1

Безопасность

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. Значение отсутствует, если разрушение данных отключены. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Свойство 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 Netscape Communications Corporation