Navigator

Baseline 广泛可用 *

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

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

可以使用只读的 window.navigator 属性检索 Navigator 对象。

实例属性

不继承任何属性。

标准属性

Navigator.bluetooth 只读实验性安全上下文: 返回当前文档的 Bluetooth 对象，提供对 Web Bluetooth API 功能的访问。
Navigator.clipboard 只读安全上下文: 返回一个 Clipboard 对象，该对象提供对系统剪贴板的读写访问。
Navigator.connection 只读: 返回一个 NetworkInformation 对象，其中包含有关设备网络连接的信息。
Navigator.contacts 只读实验性安全上下文: 返回一个 ContactsManager 接口，允许用户从其联系人列表中选择条目，并将所选条目的有限详细信息与网站或应用程序共享。
Navigator.cookieEnabled 只读: 如果设置 Cookie 将被忽略，则返回 false；否则返回 true。
Navigator.credentials 只读安全上下文: 返回 CredentialsContainer 接口，该接口公开了请求凭据和在发生有趣事件（例如成功登录或注销）时通知用户代理的方法。
Navigator.deviceMemory 只读安全上下文: 返回以千兆字节为单位的设备内存量。此值是通过四舍五入到最接近的 2 的幂并将该数字除以 1024 得到的近似值。
Navigator.devicePosture 只读实验性: 返回浏览器的 DevicePosture 对象，它允许开发者查询设备的当前姿态（即视口是处于平面状态还是折叠状态），并根据姿态变化运行代码。
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 文件时以内联方式显示 PDF 文件，则返回 true；否则返回 false。
Navigator.permissions 只读: 返回一个 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 对象（VRDisplay.isPresenting 为 true）。
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，该 Promise 解析为一个 BatteryManager 对象，该对象返回有关电池充电状态的信息。
Navigator.getGamepads(): 返回一个 Gamepad 对象数组，每个连接到设备的 Gamepad 对应一个。
Navigator.getInstalledRelatedApps() 实验性安全上下文: 返回一个 Promise，该 Promise 解析为一个对象数组，表示用户已安装的任何相关的原生应用程序或渐进式 Web 应用程序。
Navigator.registerProtocolHandler() 安全上下文: 允许网站将自己注册为给定协议的可能处理程序。
Navigator.requestMediaKeySystemAccess() 安全上下文: 返回一个 Promise，用于 MediaKeySystemAccess 对象。
Navigator.requestMIDIAccess() 安全上下文: 返回一个 Promise，表示请求访问用户系统上的 MIDI 设备。
Navigator.sendBeacon(): 用于使用 HTTP 从用户代理异步传输少量数据到 Web 服务器。
Navigator.setAppBadge() 安全上下文: 在此应用程序关联的图标上设置徽章，并返回一个解析为 undefined 的 Promise。
Navigator.share() 安全上下文: 调用当前平台的原生共享机制。
Navigator.vibrate(): 使支持振动的设备振动。如果不支持振动，则不执行任何操作。
Navigator.unregisterProtocolHandler() 安全上下文: 注销作为给定协议处理程序的网站。

已废弃的方法

Navigator.getUserMedia() 已弃用安全上下文: 在提示用户许可后，返回与本地计算机上的摄像头或麦克风关联的音频或视频流。
Navigator.getVRDisplays() 已弃用非标准: 返回一个 Promise，该 Promise 解析为一个 VRDisplay 对象数组，表示连接到计算机的任何可用 VR 设备。
Navigator.javaEnabled(): 始终返回 false。
Navigator.taintEnabled(): 返回 false。JavaScript taint/untaint 函数在 JavaScript 1.2 中已删除。

规范

规范
HTML # the-navigator-object

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后由 MDN 贡献者在 2025 年 8 月 25 日修改。

在 GitHub 上查看此页面 • 报告此内容的问题