Navigator
The Navigator
interface represents the state and the identity of the user agent. It allows scripts to query it and to register themselves to carry on some activities.
A Navigator
object can be retrieved using the read-only Window.navigator
property.
Properties
Doesn't inherit any property, but implements those defined in NavigatorID
, NavigatorLanguage
, NavigatorOnLine
, NavigatorContentUtils
, NavigatorStorageUtils
, NavigatorCookies
, NavigatorConcurrentHardware
, NavigatorPlugins
, and NavigatorUserMedia
.
Standard
Navigator.activeVRDisplays
Read only- Returns an array containing every
VRDisplay
object that is currently presenting (VRDisplay.ispresenting
istrue
). NavigatorID.appCodeName
Read only- Returns the internal "code" name of the current browser. Do not rely on this property to return the correct value.
NavigatorID.appName
Read only- Returns a
DOMString
with the official name of the browser. Do not rely on this property to return the correct value. NavigatorID.appVersion
Read only- Returns the version of the browser as a
DOMString
. Do not rely on this property to return the correct value. Navigator.battery
Read only- Returns a
BatteryManager
object you can use to get information about the battery charging status. Navigator.connection
Read only- Provides a
NetworkInformation
object containing information about the network connection of a device. Navigator.geolocation
Read only- Returns a
Geolocation
object allowing accessing the location of the device. NavigatorConcurrentHardware.hardwareConcurrency
Read only- Returns the number of logical processor cores available.
NavigatorPlugins.javaEnabled
Read only- Returns a
Boolean
flag indicating whether the host browser is Java-enabled or not. NavigatorLanguage.language
Read only- Returns a
DOMString
representing the preferred language of the user, usually the language of the browser UI. Thenull
value is returned when this is unknown. NavigatorLanguage.languages
Read only- Returns an array of
DOMString
representing the languages known to the user, by order of preference. NavigatorPlugins.mimeTypes
Read only- Returns an
MimeTypeArray
listing the MIME types supported by the browser. NavigatorOnLine.onLine
Read only- Returns a
Boolean
indicating whether the browser is working online. Navigator.oscpu
- Returns a string that represents the current operating system.
Navigator.permissions
Read only- Returns a
Permissions
object that can be used to query and update permission status of APIs covered by the Permissions API. NavigatorID.platform
Read only- Returns a string representing the platform of the browser. Do not rely on this function to return a significant value.
NavigatorPlugins.plugins
Read only- Returns a
PluginArray
listing the plugins installed in the browser. NavigatorID.product
Read only- Always returns
'Gecko'
, on any browser. This property is kept only for compatibility purpose. NavigatorID.userAgent
Read only- Returns the user agent string for the current browser.
Navigator.serviceWorker
Read only- Returns a
ServiceWorkerContainer
object, which provides access to registration, removal, upgrade, and communication with theServiceWorker
objects for the associated document.
Non-standard
Firefox OS devices adds more non-standard properties. You can consult them on the Firefox OS Navigator extensions article.
- Returns the build identifier of the browser (e.g., "2006090803").
Navigator.cookieEnabled
- Returns a boolean indicating whether cookies are enabled in the browser or not.
Navigator.credentials
- Returns the
CredentialsContainer
interface which exposes methods to request credentials and notify the user agent when interesting events occur such as successful sign in or sign out. Navigator.doNotTrack
- Reports the value of the user's do-not-track preference. When this value is "yes", your web site or application should not track the user.
Navigator.id
- Returns the
id
object which you can use to add support for BrowserID to your web site. Navigator.mediaDevices
- Returns a reference to the
MediaDevices
interface. Navigator.mozNotification
Deprecated since Gecko 22
Navigator.webkitNotification
- Returns a
notification
object you can use to deliver notifications to the user from your web application. Navigator.mozSocial
- The Object, returned by the
navigator.mozSocial
property, is available within the social media provider's panel to provide functionality it may need. Navigator.presentation
- Returns a reference to the
Presentation
API. Navigator.productSub
- Returns the build number of the current browser (e.g., "20060909").
Navigator.securitypolicy
- Returns an empty string. In Netscape 4.7x, returns "US & CA domestic policy" or "Export policy".
Navigator.standalone
- Returns a boolean indicating whether the browser is running in standalone mode. Available on Apple's iOS Safari only.
Navigator.vendor
- Returns the vendor name of the current browser (e.g., "Netscape6").
Navigator.vendorSub
- Returns the vendor version number (e.g. "6.1").
Navigator.webkitPointer
- Returns a PointerLock object for the Mouse Lock API.
Methods
Doesn't inherit any method, but implements those defined in NavigatorID
, NavigatorContentUtils
, NavigatorUserMedia
, and NavigatorStorageUtils
.
Standard
Navigator.getVRDisplays()
- Returns a promise that resolves to an array of
VRDisplay
objects representing any available VR devices connected to the computer. Navigator.getUserMedia()
- After having prompted the user for permission, returns the audio or video stream associated to a camera or microphone on the local computer.
Navigator.registerContentHandler()
- Allows web sites to register themselves as a possible handler for a given MIME type.
Navigator.registerProtocolHandler()
- Allows web sites to register themselves as a possible handler for a given protocol.
Navigator.requestMediaKeySystemAccess()
- Returns a
Promise
for a MediaKeySystemAccess object. Navigator.sendBeacon()
- Used to asynchronously transfer a small amount of data using HTTP from the User Agent to a web server.
NavigatorID.taintEnabled()
Deprecated since Gecko 1.7.8 Obsolete since Gecko 9.0- Returns
false
. JavaScript taint/untaint functions removed in JavaScript 1.2. Navigator.vibrate()
- Causes vibration on devices with support for it. Does nothing if vibration support isn't available.
Non-standard
Firefox OS devices adds more non-standard methods. You can consult them on the Firefox OS Navigator extensions article.
Navigator.mozIsLocallyAvailable()
- Lets code check to see if the document at a given URI is available without using the network.
Navigator.mozPay()
- Allows in-app payment.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/navigator