Your Search Results

Navigator

In This Article

Properties
1. Standard
2. Non-standard
Methods
1. Standard
2. Non-standard

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

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

Firefox OS devices adds more non-standard properties. You can consult them on the Firefox OS Navigator extensions article.

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

NavigatorUserMedia.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 small HTTP data 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.getVRDevices(): Returns a promise that resolves to an array of objects representing any VR devices that are connected to the computer and compatible with the browser.
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.

Document Tags and Contributors

Tags:

Contributors to this page: jpmedley, Potch, Sheppy, teoli, AFBarstow, chrisdavidmills, Ted_Mielczarek, Meggin, Alhadis, sayanchowdhury, Sephr, veeramani.n, wbamberg, Jeremie

Last updated by: jpmedley, Apr 15, 2016, 9:20:21 AM