Navigator

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

* Some parts of this feature may have varying levels of support.

TheNavigator 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.

ANavigator object can be retrieved using the read-onlywindow.navigator property.

Instance properties

Doesn't inherit any properties.

Standard properties

Navigator.bluetoothRead onlyExperimentalSecure context: Returns a Bluetooth object for the current document, providing access toWeb Bluetooth API functionality.
Navigator.clipboardRead onlySecure context: Returns aClipboard object that provides read and write access to the system clipboard.
Navigator.connectionRead only: Returns aNetworkInformation object containing information about the network connection of a device.
Navigator.contactsRead onlyExperimentalSecure context: Returns a ContactsManager interface which allows users to select entries from their contact list and share limited details of the selected entries with a website or application.
Navigator.cookieEnabledRead only: Returns false if setting a cookie will be ignored and true otherwise.
Navigator.credentialsRead onlySecure context: Returns theCredentialsContainer 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.deviceMemoryRead onlySecure context: 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.devicePostureRead onlyExperimental: Returns the browser's DevicePosture object, which allows developers to query the device's current posture (that is, whether the viewport is in a flat or folded state) and run code in response to posture changes.
Navigator.geolocationRead only: Returns aGeolocation object allowing accessing the location of the device.
Navigator.gpuRead onlySecure context: Returns theGPU object for the current browsing context. The entry point for theWebGPU API.
Navigator.hardwareConcurrencyRead only: Returns the number of logical processor cores available.
Navigator.hidRead onlyExperimentalSecure context: Returns an HID object providing methods for connecting to HID devices, listing attached HID devices, and event handlers for connected HID devices.
Navigator.inkRead onlyExperimental: Returns an Ink object for the current document, providing access toInk API functionality.
Navigator.keyboardRead onlyExperimentalSecure context: Returns a Keyboard object which provides access to functions that retrieve keyboard layout maps and toggle capturing of key presses from the physical keyboard.
Navigator.languageRead only: Returns a string representing the preferred language of the user, usually the language of the browser UI. Thenull value is returned when this is unknown.
Navigator.languagesRead only: Returns an array of strings representing the languages known to the user, by order of preference.
Navigator.locksRead onlySecure context: Returns aLockManager object that provides methods for requesting a newLock object and querying for an existingLock object.
Navigator.loginRead onlySecure context: Provides access to the browser'sNavigatorLogin object, which a federated identity provider (IdP) can use to set a user's login status when they sign into or out of the IdP. SeeFederated Credential Management (FedCM) API for more details.
Navigator.maxTouchPointsRead only: Returns the maximum number of simultaneous touch contact points are supported by the current device.
Navigator.mediaCapabilitiesRead only: Returns aMediaCapabilities object that can expose information about the decoding and encoding capabilities for a given format and output capabilities.
Navigator.mediaDevicesRead onlySecure context: Returns a reference to aMediaDevices 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.mediaSessionRead only: ReturnsMediaSession object which can be used to provide metadata that can be used by the browser to present information about the currently-playing media to the user, such as in a global media controls UI.
Navigator.onLineRead only: Returns a boolean value indicating whether the browser is working online.
Navigator.pdfViewerEnabledRead only: Returnstrue if the browser can display PDF files inline when navigating to them, andfalse otherwise.
Navigator.permissionsRead only: Returns aPermissions object that can be used to query and update permission status of APIs covered by thePermissions API.
Navigator.presentationRead onlySecure context: Returns a reference to thePresentation API.
Navigator.schedulingRead onlyExperimental: Returns a Scheduling object for the current document.
Navigator.serialRead onlyExperimentalSecure context: Returns a Serial object, which represents the entry point into theWeb Serial API to enable the control of serial ports.
Navigator.serviceWorkerRead onlySecure context: Returns aServiceWorkerContainer object, which provides access to registration, removal, upgrade, and communication with theServiceWorker objects for theassociated document.
Navigator.storageRead onlySecure context: Returns the singletonStorageManager object used for managing persistence permissions and estimating available storage on a site-by-site/app-by-app basis.
Navigator.usbRead onlySecure context: Returns aUSB object for the current document, providing access toWebUSB API functionality.
Navigator.userActivationRead only: Returns aUserActivation object containing information about the current window's user activation state.
Navigator.userAgentRead only: Returns the user agent string for the current browser.
Navigator.userAgentDataRead onlyExperimentalSecure context: Returns a NavigatorUAData object, which gives access to information about the browser and operating system of the user.
Navigator.virtualKeyboardRead onlyExperimentalSecure context: Returns a reference to the VirtualKeyboard API, to take control of the on-screen virtual keyboard.
Navigator.wakeLockRead onlySecure context: Returns aWakeLock interface you can use to request screen wake locks and prevent screen from dimming, turning off, or showing a screen saver.
Navigator.webdriverRead only: Indicates whether the user agent is controlled by automation.
Navigator.windowControlsOverlayRead onlySecure context: Returns theWindowControlsOverlay interface which exposes information about the geometry of the title bar in desktop Progressive Web Apps, and an event to know whenever it changes.
Navigator.xrRead onlyExperimentalSecure context: Returns XRSystem object, which represents the entry point into theWebXR API.

Non-standard properties

Navigator.buildIDRead onlyNon-standard: 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.globalPrivacyControlRead onlyExperimental: Returns a boolean indicating a user's consent to their information being shared or sold.
Navigator.standaloneNon-standard: Returns a boolean indicating whether the browser is running in standalone mode. Available on Apple's iOS Safari only.

Deprecated properties

Navigator.activeVRDisplaysRead onlyDeprecated Non-standard: Returns an array containing every VRDisplay object that is currently presenting (VRDisplay.isPresenting istrue).
Navigator.appCodeNameRead only: Always returns'Mozilla', in any browser.
Navigator.appNameRead only: Always returns'Netscape', in any browser.
Navigator.appVersionRead only: Returns the version of the browser as a string. Do not rely on this property to return the correct value.
Navigator.doNotTrackRead onlyDeprecated Non-standard: Reports the value of the user's do-not-track preference. When this value is "1", your website or application should not track the user.
Navigator.mimeTypesRead only: Returns aMimeTypeArray listing the MIME types supported by the browser.
Navigator.oscpuRead only: Returns a string that represents the current operating system.
Navigator.platformRead only: Returns a string representing the platform of the browser. Do not rely on this function to return a significant value.
Navigator.pluginsRead only: Returns aPluginArray listing the plugins installed in the browser.
Navigator.productRead only: Always returns'Gecko', in any browser.
Navigator.productSubRead only: Returns either the string'20030107', or'"20100101'.
Navigator.vendorRead only: Returns either the empty string,'Apple Computer Inc.', or'Google Inc.'.
Navigator.vendorSubRead only: Always returns the empty string.