Navigator

Navigator 介面標示了用戶代理（user agent）的狀態與身份。它允許腳本查詢與註冊，以進行一些活動。

Navigator 可以被檢索，只要使用唯讀的 window.navigator 屬性。

屬性

它並不繼承任何屬性，但其實做已被定義於 NavigatorID (en-US)、NavigatorLanguage (en-US)、NavigatorOnLine、NavigatorContentUtils、NavigatorStorage (en-US)、NavigatorStorageUtils、NavigatorConcurrentHardware (en-US)、NavigatorPlugins (en-US)、NavigatorUserMedia.

標準

Navigator.activeVRDisplays (en-US) Read only 實驗性質: Returns an array containing every VRDisplay (en-US) object that is currently presenting (VRDisplay.ispresenting (en-US) is true).
NavigatorID.appCodeName (en-US) Read only 實驗性質: Returns the internal "code" name of the current browser. Do not rely on this property to return the correct value.
NavigatorID.appName (en-US) 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 (en-US) Read only 實驗性質: Returns the version of the browser as a DOMString. Do not rely on this property to return the correct value.
Navigator.battery (en-US) Read only: Returns a BatteryManager (en-US) object you can use to get information about the battery charging status.
Navigator.connection (en-US) Read only 實驗性質: Provides a NetworkInformation (en-US) object containing information about the network connection of a device.
Navigator.cookieEnabled (en-US) 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 (en-US) Read only: Returns the number of logical processor cores available.
NavigatorPlugins.javaEnabled (en-US) Read only 實驗性質: Returns a Boolean (en-US) 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 (en-US) Read only: Returns an array of DOMString representing the languages known to the user, by order of preference.
NavigatorPlugins.mimeTypes (en-US) Read only 實驗性質: Returns an MimeTypeArray (en-US) listing the MIME types supported by the browser.
NavigatorOnLine.onLine (en-US) Read only: Returns a Boolean (en-US) indicating whether the browser is working online.
Navigator.oscpu (en-US): Returns a string that represents the current operating system.
Navigator.permissions (en-US) Read only 實驗性質: Returns a Permissions (en-US) object that can be used to query and update permission status of APIs covered by the Permissions API.
NavigatorID.platform (en-US) Read only 實驗性質: Returns a string representing the platform of the browser. Do not rely on this function to return a significant value.
NavigatorPlugins.plugins (en-US) Read only 實驗性質: Returns a PluginArray (en-US) listing the plugins installed in the browser.
NavigatorID.product (en-US) Read only 實驗性質: Always returns 'Gecko', on any browser. This property is kept only for compatibility purpose.
Navigator.serviceWorker (en-US) Read only: Returns a ServiceWorkerContainer (en-US) object, which provides access to registration, removal, upgrade, and communication with the ServiceWorker (en-US) objects for the associated document.
Navigator.storage (en-US) Read only: Returns the singleton StorageManager (en-US) object used for managing persistance permissions and estimating available storage on a site-by-site/app-by-app basis.
NavigatorID.userAgent (en-US) Read only: Returns the user agent string for the current browser.

Non-standard

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

Navigator.buildID (en-US) 非標準: Returns the build identifier of the browser (e.g., "2006090803").
Navigator.cookieEnabled (en-US) 非標準: Returns a boolean indicating whether cookies are enabled in the browser or not.
Navigator.credentials (en-US) 非標準: Returns the CredentialsContainer (en-US) 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 (en-US) 非標準: 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 (en-US) 非標準: 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() (en-US)), and to request access to media using MediaDevices.getUserMedia() (en-US).
Navigator.mozNotification 已棄用非標準 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 (en-US) 非標準: Returns a reference to the Presentation (en-US) API.
Navigator.productSub (en-US) 非標準: 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 (en-US) interface which provides means to query and request storage usage and quota information.
Navigator.vendor (en-US) 非標準: Returns the vendor name of the current browser (e.g., "Netscape6").
Navigator.vendorSub (en-US) 非標準: Returns the vendor version number (e.g. "6.1").
Navigator.webkitPointer 非標準: Returns a PointerLock object for the Mouse Lock API (en-US).

方法

Doesn't inherit any method, but implements those defined in NavigatorID (en-US), NavigatorContentUtils, NavigatorUserMedia, and NavigatorStorageUtils.

Standard

Navigator.getVRDisplays() (en-US) 實驗性質: Returns a promise that resolves to an array of VRDisplay (en-US) objects representing any available VR devices connected to the computer.
Navigator.getUserMedia() (en-US) 實驗性質: 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() (en-US) 實驗性質: Returns a Promise for a MediaKeySystemAccess object.
Navigator.sendBeacon() (en-US) 實驗性質: Used to asynchronously transfer a small amount of data using HTTP from the User Agent to a web server.
Navigator.share() (en-US) 實驗性質: Invokes the native sharing mechanism of the current platform.
NavigatorID.taintEnabled() (en-US) 已棄用實驗性質: Returns false. JavaScript taint/untaint functions removed in JavaScript 1.2.
Navigator.vibrate() (en-US): 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() (en-US) 非標準: Lets code check to see if the document at a given URI is available without using the network.
Navigator.mozPay() 非標準: Allows in-app payment.