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.

Navigator 接口代表了用户代理的状态和身份，它允许脚本对其进行查询并注册自身以便执行某些活动。

可以通过 window.navigator 只读属性获取 Navigator 对象。

实例属性

不继承任何属性。

标准属性

Navigator.bluetooth 只读实验性安全上下文: 返回一个当前文档的 Bluetooth 对象，提供对 web 蓝牙 API 功能的访问。
Navigator.clipboard 只读安全上下文: 返回一个用于读写访问系统剪贴板内容的 Clipboard 对象。
Navigator.connection 只读: 返回一个包含有关网络连接信息的 NetworkInformation 对象。
Navigator.contacts 只读实验性安全上下文: 返回一个 ContactsManager 接口，允许用户从他们的联系人列表中选择条目，并与网站或应用程序共享所选条目的有限详细信息。
Navigator.cookieEnabled 只读: 如果设置 cookie 会被忽略则返回 false，否则返回 true。
Navigator.credentials 只读安全上下文: 返回 CredentialsContainer 接口，该接口暴露了请求凭据及在成功登录或注销等重要事件发生时通知用户代理的方法。
Navigator.deviceMemory 只读安全上下文: 返回设备内存的近似值。该值通过向下取整到最接近的 2 的幂，然后将其除以 1024 来近似。
Navigator.geolocation 只读: 返回一个 Geolocation 对象，用于访问设备的位置。
Navigator.gpu 只读实验性安全上下文: 返回当前浏览上下文的 GPU 对象。是 WebGPU API 的入口点。
Navigator.hardwareConcurrency 只读: 返回可用的逻辑处理器核心数量。
Navigator.hid 只读实验性安全上下文: 返回一个 HID 对象，提供用于连接 HID 设备、列出已连接的 HID 设备以及连接的 HID 设备的事件处理程序的方法。
Navigator.ink 只读实验性: 返回一个当前文档的 Ink 对象，提供对 Ink API 功能的访问。
Navigator.keyboard 只读实验性安全上下文: 返回一个 Keyboard 对象，该对象可用于访问检索键盘布局映射和切换捕捉物理键盘按键的函数。
Navigator.language 只读: 返回一个字符串，表示用户的首选语言，通常是浏览器 UI 的语言。如果未知，则返回 null 值。
Navigator.languages 只读: 返回一个字符串数组，表示用户的首选语言，按优先级排序。
Navigator.locks 只读安全上下文: 返回一个 LockManager 对象，提供了请求新的 Lock 对象和查询现有的 Lock 对象的方法。
Navigator.login 只读实验性安全上下文: 提供对浏览器 NavigatorLogin 对象的访问权限，联合身份提供程序（IdP）可以使用它在用户登录或退出 IdP 时设置其登录状态。更多详细信息请参阅联合凭证管理（FedCM）API。
Navigator.maxTouchPoints 只读: 返回当前设备支持的最大同时触摸接触点数。
Navigator.mediaCapabilities 只读: 返回一个 MediaCapabilities 对象，可以暴露有关给定格式的解码和编码能力。
Navigator.mediaDevices 只读安全上下文: 返回一个 MediaDevices 对象的引用，可用于获取有关可用媒体设备的信息（MediaDevices.enumerateDevices()）、了解计算机用户和用户代理支持的媒体约束属性（MediaDevices.getSupportedConstraints()）、以及请求访问媒体资源 MediaDevices.getUserMedia()。
Navigator.mediaSession 只读: 返回 MediaSession 对象，可用于向浏览器提供有关当前播放媒体的元数据，以便在全局媒体控制 UI 中向用户展示相关信息。
Navigator.onLine 只读: 返回浏览器的在线状态。该属性返回一个布尔值。
Navigator.pdfViewerEnabled 只读: 如果浏览器在导航到 PDF 文件时可以使用它们，返回 true，否则为 false。
Navigator.permissions 只读: 返回一个 Permissions 对象，可以用来查询和更新受权限 API 支持的 API 的权限状态。
Navigator.presentation 只读安全上下文: 返回一个对 Presentation API 的引用。
Navigator.scheduling 只读实验性: 返回一个当前文档的 Scheduling 对象。
Navigator.serial 只读实验性安全上下文: 返回一个 Serial 对象，代表了进入 Web Serial API 的入口点，用于控制串行端口。
Navigator.serviceWorker 只读安全上下文: 返回一个 ServiceWorkerContainer 对象，它提供了注册、移除、升级以及与相关文档的 ServiceWorker 对象进行通信的功能。
Navigator.storage 只读安全上下文: 返回用于按站点或按应用管理持久化权限及估算可用存储空间的单例 StorageManager 对象。
Navigator.usb 只读安全上下文: 返回一个当前文档的 USB 对象，提供对 WebUSB API 功能的访问。
Navigator.userActivation 只读: 返回一个包含有关当前窗口用户激活状态的信息的 UserActivation 对象。
Navigator.userAgent 只读: 返回当前浏览器的用户代理。
Navigator.userAgentData 只读实验性安全上下文: 返回一个 NavigatorUAData 对象，提供了关于用户浏览器和操作系统的信息。
Navigator.virtualKeyboard 只读实验性安全上下文: 返回一个 VirtualKeyboard API 的引用，以控制屏幕上的虚拟键盘。
Navigator.wakeLock 只读安全上下文: 返回一个 WakeLock 接口，你可以使用它来请求屏幕唤醒锁并防止屏幕变暗、关闭或显示屏幕保护程序。
Navigator.webdriver 只读: 表示用户代理是否受自动化控制。
Navigator.windowControlsOverlay 只读安全上下文: 返回 WindowControlsOverlay 接口，该接口暴露了桌面渐进式 Web 应用程序标题栏的几何信息，以及在标题栏发生变化时触发的事件。
Navigator.xr 只读实验性安全上下文: 返回 XRSystem 对象，它代表了进入 WebXR API 的入口点。

非标准的属性

Navigator.buildID 只读非标准: 返回浏览器的构建标识符。在现代浏览器中，为了保护隐私，该属性现在返回一个固定的时间戳，例如 Firefox 64 及更高版本中返回 20181001000000。
Navigator.globalPrivacyControl 只读实验性非标准: 返回一个布尔值，表示用户是否同意共享或出售他们的信息。
Navigator.standalone 非标准: 返回一个布尔值，表示浏览器是否以独立模式运行。仅在 Apple 的 iOS Safari 上可用。

已弃用的属性

Navigator.activeVRDisplays 只读已弃用非标准: 返回一个包含所有当前正在呈现（VRDisplay.ispresenting 为 true）的 VRDisplay 对象的数组。
Navigator.appCodeName 只读已弃用: 在任何浏览器中始终返回 'Mozilla'。
Navigator.appName 只读已弃用: 在任何浏览器中始终返回 'Netscape'。
Navigator.appVersion 只读已弃用: 返回浏览器版本号字符串。请勿依赖此属性返回正确的值。
Navigator.doNotTrack 只读已弃用非标准: 报告用户的请勿追踪设置的首选项的值，当该值为“1”时，你的网站或应用程序不应该跟踪用户。
Navigator.mimeTypes 只读已弃用: 返回一个 MimeTypeArray 对象，表示浏览器识别和支持的 MIME 类型。
Navigator.oscpu 只读已弃用: 返回一个表示当前操作系统版本的字符串。
Navigator.platform 只读已弃用: 返回一个表示浏览器平台的字符串。请勿依赖此函数返回重要值。
Navigator.plugins 只读已弃用: 返回一个 PluginArray 对象，列出了浏览器中安装的所有插件。
Navigator.product 只读已弃用: 在任何浏览器中始终返回 'Gecko'。
Navigator.productSub 只读已弃用: 返回字符串 '20030107' 或 '20100101'。
Navigator.vendor 只读已弃用: 返回空字符串、'Apple Computer Inc.' 或 'Google Inc.'。
Navigator.vendorSub 只读已弃用: 始终返回空字符串。

实例方法

不继承任何方法。

Navigator.canShare() 安全上下文: 如果调用 Navigator.share() 成功，则返回 true。
Navigator.clearAppBadge() 安全上下文: 清除当前应用图标的徽标，并返回一个兑现为 undefined 的 Promise 对象。
Navigator.deprecatedReplaceInURN() 实验性: 针对给定的不透明 URN 或 FencedFrameConfig 的内部 url 属性，在映射 URL 中替换指定字符串。此方法作为临时措施（标记为“已弃用”）提供，以支持对围栏框架 URL 执行此类替换，帮助广告技术提供商将现有的实现迁移到隐私沙盒 API。
Navigator.getAutoplayPolicy() 实验性: 返回一个值，表示指定的媒体元素、音频上下文或媒体特性“类型”是否允许自动播放。
Navigator.getBattery() 安全上下文: 返回一个 promise，兑现为一个 BatteryManager 对象，返回有关电池充电状态的信息。
Navigator.getGamepads(): 返回一个 Gamepad 数组对象，对应每一个设备上连接的手柄。
Navigator.getInstalledRelatedApps() 实验性安全上下文: 返回一个 promise，当敲定时会提供一个对象数组，这些对象代表着用户已安装的任何相关原生应用或渐进式 Web 应用（PWA）的信息。
Navigator.registerProtocolHandler() 安全上下文: 允许网站注册自身为特定协议的潜在处理程序。
Navigator.requestMediaKeySystemAccess() 安全上下文: 返回一个表示 MediaKeySystemAccess 对象的 Promise。
Navigator.requestMIDIAccess() 安全上下文: 返回一个 Promise 对象，代表了请求访问用户系统上的 MIDI 设备的操作。
Navigator.sendBeacon(): 用于通过 HTTP 协议异步地从用户代理向 Web 服务器传输少量数据。
Navigator.setAppBadge() 安全上下文: 在与此应用程序关联的图标上设置徽标，并返回一个兑现为 undefined 的 Promise 对象。
Navigator.share() 安全上下文: 调用当前平台的原生分享机制。
Navigator.vibrate(): 在支持振动功能的设备上触发振动。若设备不支持振动功能，则此方法无效。
Navigator.unregisterProtocolHandler() 安全上下文: 注销作为指定协议处理程序的网站。

已弃用的方法

Navigator.getUserMedia() 已弃用安全上下文: 在向用户请求权限后，返回与本地计算机上的摄像头或麦克风关联的音频或视频流。
Navigator.getVRDisplays() 已弃用非标准: 返回一个 promise，该 promise 兑现为一个数组中包含了代表连接到计算机的所有可用 VR 设备的 VRDisplay 对象。
Navigator.javaEnabled() 已弃用: 始终返回 false。
Navigator.taintEnabled() 已弃用: 在 JavaScript 1.2 版本中移除了对数据污染/净化函数的支持，其返回值为 false。

规范

Specification
HTML Standard # the-navigator-object

浏览器兼容性

BCD tables only load in the browser