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, NavigatorPlugins, NavigatorUserMedia, and NetworkInformation.

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.
NetworkInformation.connection Read only: Provides a Connection with information about the network connection of a device.
Navigator.geolocation Read only: Returns a Geolocation object allowing accessing the location of the device.
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.
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.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.mozAlarms Requires FirefoxOS 1.0: Returns a MozAlarmsManager object you can use to schedule notifications or applications to be started at a specific time.
navigator.mozApps: Returns an Apps object you can use to install, manage, and control Open Web apps.
navigator.mozAudioChannelManager: The navigator.mozAudioChannelManager object provides access to the mozAudioChannelManager interface, which is used to manage your Firefox OS device's audio channels, including setting what channel's volume to affect when the volume buttons are pressed inside a particular app.
navigator.mozCamera Requires FirefoxOS 1.0: Return a CameraManager object you can use to access cameras available on your device.
navigator.mozFMRadio Requires FirefoxOS 1.0: Return an FMRadio object you can use to access the device FM radio.
navigator.mozMobileConnection Requires FirefoxOS 1.0: Return a MozMobileConnection object to retrieve the connection states of a mobile device and to perform some SIM/RUIM card actions.
navigator.mozMobileMessage Requires FirefoxOS 1.1: Returns a MozMobileMessageManager object you can use to manage MMS and SMS messaging in your web application.
navigator.mozNetworkStats Requires FirefoxOS 1.0: Returns a MozNetworkStatsManager object you can use to access network data amount information.
navigator.mozNfc Requires FirefoxOS 2.0: Returns a MozNFC object that can be used to access Near Field Communication (NFC) functionality, allowing two phones to have data transferred between one another simply by holding them close or tapping them together.
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.mozPower Requires FirefoxOS 1.0: Returns a PowerManager object that allows to control the power usage and turn off unused peripherals to save power.
navigator.mozSettings Requires FirefoxOS 1.0: Returns a SettingsManager object you can use to access the device's settings.
navigator.mozSms Requires FirefoxOS 1.0 Deprecated since Gecko 25: Returns a MozSmsManager object you can use to manage SMS messaging in 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.mozTCPSocket Requires FirefoxOS 1.0: Returns a TCPSocket object that allows to open a raw TCP connection.
navigator.mozTelephony Requires FirefoxOS 1.0: Returns a Telephony object you can use to create and manage telephone calls.
navigator.mozWifiManager Requires FirefoxOS 1.0: Returns a WifiManager object you can use to manage Wifi networks.
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.
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.addIdleObserver Requires FirefoxOS 1.0: Allows to add an observer to check when the user is idle.
navigator.getDataStores Requires FirefoxOS 1.0: Provides access to a list of the Data Store API data stores available on the device.
navigator.getDeviceStorage Requires FirefoxOS 1.0: Gives access to device storage areas.
navigator.getDeviceStorages Requires FirefoxOS 1.0: Gives access to all the device storage areas of the same type.
navigator.mozHasPendingMessage Requires FirefoxOS 1.0: Allows an app to know if there is a pending message of a given type.
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.
navigator.mozSetMessageHandler Requires FirefoxOS 1.0: Allows an app to register a function handler for any kind of system message.
navigator.preference Obsolete since Gecko 2.0: Sets a user preference. This method is only available to privileged code and is obsolete; you should use the XPCOM Preferences API instead.
navigator.removeIdleObserver Requires FirefoxOS 1.0: Allows to remove an observer used to check if the user is idle.
navigator.requestWakeLock: Request a wake lock for a resource. A wake lock prevents a specific part of a device from being turned off automatically.

Document Tags and Contributors

Tags:

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

Last updated by: jpmedley, Mar 9, 2015 8:52:54 AM

Hide Sidebar