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 properties, but implements those defined in NavigatorID
, NavigatorLanguage
, NavigatorOnLine
, NavigatorContentUtils
, NavigatorStorage
, NavigatorStorageUtils
, 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.cookieEnabled
Read only- Returns false if setting a cookie will be ignored and true otherwise.
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. Navigator.keyboard
Read only- Returns a
Keyboard
object which provides access to functions that retrieve keyboard layout maps and toggle capturing of key presses from the physical keyboard. 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. Navigator.locks
Read only- Returns a
LockManager
object which provides methods for requesting a newLock
object and querying for an existingLock
object Navigator.mediaCapabilities
Read only- Returns a
MediaCapabilities
object that can expose information about the decoding and encoding capabilities for a given format and output capabilities. Navigator.maxTouchPoints
Read only- Returns the maximum number of simultaneous touch contact points are supported by the current device.
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. Navigator.serviceWorker
Read only- Returns a
ServiceWorkerContainer
object, which provides access to registration, removal, upgrade, and communication with theServiceWorker
objects for the associated document. NavigatorStorage.storage
Read only- Returns the singleton
StorageManager
object used for managing persistence permissions and estimating available storage on a site-by-site/app-by-app basis. NavigatorID.userAgent
Read only- Returns the user agent string for the current browser.
Navigator.webdriver
Read only- Indicates whether the user agent is controlled by automation.
Non-standard
Navigator.buildID
- Returns the build identifier of the browser. In modern browsers this property now returns a fixed timestamp as a privacy measure, e.g.
20181001000000
in Firefox 64 onwards. 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.deviceMemory
Read only- Returns the amount of device memory in gigabytes. This value is an approximation given by rounding to the nearest power of 2 and dividing that number by 1024.
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.mediaDevices
- Returns a reference to a
MediaDevices
object which can then be used to get information about available media devices (MediaDevices.enumerateDevices()
), find out what constrainable properties are supported for media on the user's computer and user agent (MediaDevices.getSupportedConstraints()
), and to request access to media usingMediaDevices.getUserMedia()
. 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.storageQuota
Read only- Returns a
StorageQuota
interface which provides means to query and request storage usage and quota information. 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.canShare()
- Returns
true
if a call toNavigator.share()
would succeed. 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()
Obsolete since Gecko 59- 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.
Navigator.share()
- Invokes the native sharing mechanism of the current platform.
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.
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'the Navigator object' in that specification. |
Living Standard |
Browser compatibility
BCD tables only load in the browser