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 is true).

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. The null 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 the ServiceWorker objects for the associated document.

Non-standard

Navigator.buildID

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

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.