Navigator
=========

Интерфейс `Navigator` представляет состояние и особенности пользовательского агента. Он позволяет скриптам запрашивать их и самостоятельно регистрироваться для выполнения некоторых действий.

Объект `Navigator` можно получить с помощью доступного только для чтения свойства `window.navigator`.

Свойства экземпляра
-------------------

*Не наследует свойства.*

### Стандартизированные

`Navigator.appCodeName` Только для чтения 
Экспериментальная возможность

Возвращает внутренний "код" текущего браузера. Не полагайтесь на это свойство для получения правильного значения.

`Navigator.appName` Только для чтения 
Экспериментальная возможность

Возвращает `DOMString` с официальным названием браузера. Не полагайтесь на это свойство для получения правильного значения.

`Navigator.appVersion` Только для чтения 
Экспериментальная возможность

Возвращает версию браузера как `DOMString`. Не полагайтесь на это свойство для получения правильного значения.

`Navigator.getBattery` Только для чтения 

Возвращает `BatteryManager` объект, который вы можете использовать для получения информации о статусе заряда аккумулятора.

`Navigator.connection` Только для чтения 
Экспериментальная возможность

Предоставляет `Connection` (en-US) с информацией о сетевом подключении устройства.

`NavigatorGeolocation.geolocation` (en-US) Только для чтения 

Возвращает `Geolocation` объект, позволяющий получить доступ к местоположению устройства.

`Navigator.javaEnabled()` 
Устарело

Возвращает всегда `false`.

`Navigator.language` Только для чтения 

Возвращает `DOMString`, представляющий предпочитаемый пользователем язык, как правило это язык пользовательского интерфейса браузера. Значение `null` возвращается, когда язык неизвестен.

`Navigator.languages` Только для чтения 

Возвращает массив `DOMString`, представляющий собой языки, известные пользователю, в порядке предпочтения.

`Navigator.mimeTypes` Только для чтения 
Экспериментальная возможность

Возвращает `MimeTypeArray` (en-US) листинг MIME типов, поддерживаемых браузером.

`Navigator.onLine` (en-US) Только для чтения 

Возвращает булево значение, показывающее имеет ли браузер подключение к сети.

`Navigator.oscpu`

Возвращает строку, показывающую имеющуюся операционную систему.

`Navigator.platform` Только для чтения 
Экспериментальная возможность

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

`Navigator.plugins` Только для чтения 
Экспериментальная возможность

Возвращает `PluginArray` (en-US) листинг плагинов, установленных в браузере.

`Navigator.product` Только для чтения  
Экспериментальная возможность

Всегда возвращает `'Gecko'`, в любом браузере. Это свойство сохраняется только для целей совместимости.

`Navigator.userAgent` (en-US) Только для чтения 

Возвращает строку агента пользователя для данного браузера.

`Navigator.serviceWorker` Только для чтения 

Возвращает `ServiceWorkerContainer` объект, который обеспечивает доступ к регистрации, удалению, обновлению и связи с `ServiceWorker` объектами для соответствующего документа.

### Не стандартизированные

`navigator.buildID` 
Non-standard

Возвращает идентификатор сборки браузера(например: "2006090803").

`Navigator.cookieEnabled` 
Non-standard

Возвращает логическое значение (boolean), показывающее включены ли куки в браузере или нет.

`navigator.doNotTrack` 
Non-standard

Значение сообщает о предпочтении пользователя не отслеживать его действия. Когда это значение "да", ваш веб сайт или приложение не должны отслеживать действия пользователя.

`navigator.productSub` 
Non-standard

Возвращает номер сборки текущего браузера(например: "20060909" ).

`navigator.securitypolicy` 
Non-standard

Возвращает пустую строку. В Netscape 4.7x, возвращает "US & CA domestic policy" или "Export policy".

`navigator.standalone` 
Non-standard

Возвращает логическое значение (boolean), показывающее работает ли браузер в автономном режиме. Доступно только в IOS Safari от Apple.

`navigator.vendor` 
Non-standard

Возвращает имя поставщика текущего браузера (например, "Netscape6").

`navigator.vendorSub` 
Non-standard

Возвращает номер версии поставщика (например, "6.1").

Методы экземпляра
-----------------

*Не наследует методы.*

### Стандартизированные

`NavigatorUserMedia.getUserMedia()`

После запроса разрешения у пользователя возвращает аудио или видео поток, взаимодействующий с камерой или микрофоном на локальном компьютере.

`navigator.registerProtocolHandler`

Разрешает веб-сайту зарегистрировать себя в качестве возможного обработчика для данного протокола.

`Navigator.taintEnabled()` 
Устарело

Экспериментальная возможность

Возвращает `false`. JavaScript taint/untaint функции отключены в JavaScript 1.2.

`Navigator.vibrate()`

Причина вибрации устройства с поддержкой её. Не делает ничего, если нет поддержки вибрации.

### Не стандартизированные

`navigator.mozIsLocallyAvailable` 
Non-standard

Позволяет коду проверить, есть ли документ в данном URI без использования сети.

`navigator.mozPay` 
Non-standard

Разрешает оплату в приложении.

`navigator.preference` 
Non-standard

Устанавливает предпочтение пользователя. Этот метод доступен только для привилегированного кода и является устаревшим; вы должны использовать вместо него XPCOM Preferences API.

`navigator.requestWakeLock` 
Non-standard

Запрос установки блокировки пробуждения для ресурса. Блокировка пробуждения препятствует определённой части устройства включится автоматически.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # the-navigator-object |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.