Этот параметр определяет продолжительность ожидания выполнения запроса в миллисекундах. По умолчанию имеет значение Infinity. По истечении указанного интервала времени будет вызвана функция обратного вызова
error
. Обратите внимание, что время ожидания разрешения пользователя на получение его местонахождения не входит в это значение параметра
timeout
.
GeolocationError
ошибка, возникшая в ходе определения
местонахождения пользователя
Если попытка определить географическое местонахождение пользователя окончилась неудачей, будет вызвана функция обратного вызова
error
с объектом
GeolocationError
, описывающим ошибку.
Константы
Следующие константы являются возможными значениями свойства code:
unsigned short PERMISSION_DENIED = 1
Пользователь не дал разрешение на определение его местонахождения.
unsigned short POSITIONJJNAVAILABLE = 2
Местонахождение не может быть определено по невыясненым причинам. Это может быть вызвано, например, сетевой ошибкой.
unsigned short TIMEOUT = 3
Местонахождение не может быть определено в течение установленного интервала времени (см. описание параметра
timeout
в справочной статье Geolocation).
Свойства
readonly unsigned short code
Это свойство может иметь одно из трех значений, описанных выше.
readonly string message
Текст сообщения, более детально описывающего ошибку. Сообщение предназначено для отладки и не подходит для уведомления конечного пользователя.
Geoposition
информация о местонахождении с указанием времени определения
Объект
Geoposition
представляет географическое местонахождение пользователя в указанный момент времени. Объекты этого типа имеют всего два свойства: время и ссылку на объект
Geocoordinates
, хранящий фактические значения координат.
Свойства
readonly Geocoordinates coords
Это свойство ссылается на объект
Geocoordinates
, свойства которого определяют широту, долготу и другие параметры местонахождения пользователя.
readonly unsigned long timestamp
Время в миллисекундах с начала эпохи, когда были определены эти координаты. При необходимости на основе этого значения можно создать объект
Date
.
HashChangeEvent
объект события, поставляемый по событию «hashchange» Event
Событие «hashchange» возбуждается броузером, когда изменяется идентификатор фрагмента (часть URL-адреса,
начинающаяся с символа решетки #) документа. Это может происходить вследствие изменения свойства
hash
объекта
Location
или при перемещении по истории посещений щелчком на кнопке броузера Back (Назад) или Forward (Вперед). В любом из этих случаев броузер генерирует событие «hashchange». Обработчику этого события передается объект
HashChangeEvent
. Подробное обсуждение механизма управления историей посещения, а также свойства
location.hash
и события «hashchange» можно найти в разделе 22.2.
Свойства
readonly string newURL
Это свойство хранит новое значение свойства
location.href
. Обратите внимание, что это полный URL-адрес, а не только идентификатор фрагмента.
readonly string oldURL
Это свойство хранит прежнее значение свойства
location.href
.
History
журнал посещений объекта Window
Объект
History
представляет историю посещений окна. Однако по соображениям безопасности объект
History
не позволяет получать из сценариев доступ к хранящимся в нем URL-адресам. Методы объекта
History
позволяют сценариям лишь перемещаться вперед и назад по истории посещений и добавлять в нее новые записи.
Свойства
readonly long length
Это свойство определяет количество URL-адресов в журнале (истории) посещений броузера. Знание размера этого списка не особенно полезно, поскольку нет способа определить индекс текущего отображаемого документа в этом списке.
Методы
void back
В результате вызова метода
back
окно или фрейм, которому принадлежит объект
Histo
ry
, заново открывает URL-адрес (если он есть), открытый непосредственно перед текущим. Вызов этого метода имеет тот же эффект, что и щелчок на кнопке Back броузера. Он также эквивалентен инструкции:
history.go(-1);
void forward
В результате вызова метода
forward
окно или фрейм, которому принадлежит объект
History
, заново открывает URL-адрес (если он есть), открытый непосредственно после текущего. Вызов этого метода имеет тот же эффект, что и щелчок на кнопке Forward броузера. Он также эквивалентен инструкции: