JavaScript. Подробное руководство, 6-е издание

  long maximumAge

Этот параметр определяет максимальное время (в миллисекундах), прошедшее с того момента, как объект Geoposition был передан функции обратного вызова success. По умолчанию имеет значение 0, т.е. каждый вызов метода getCurrentPosition или watchPosition будет заново определять местонахождение. Если установить этот параметр в значение 60000, например, то реализации будет позволено возвращать любой объект Geoposition, полученный в течение последней минуты.

  long timeout

Этот параметр определяет продолжительность ожидания выполнения запроса в миллисекундах. По умолчанию имеет значение 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 окно или фрейм, которому принадлежит объект History, заново открывает URL-адрес (если он есть), открытый непосредственно перед текущим. Вызов этого метода имеет тот же эффект, что и щелчок на кнопке Back броузера. Он также эквивалентен инструкции:

  history.go(-1);

  void forward

В результате вызова метода forward окно или фрейм, которому принадлежит объект History, заново открывает URL-адрес (если он есть), открытый непосредственно после текущего. Вызов этого метода имеет тот же эффект, что и щелчок на кнопке Forward броузера. Он также эквивалентен инструкции:

  history.go(1);