导航器

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 对象，该对象可用于查询和更新 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() 安全上下文: 清除当前应用程序图标上的徽章，并返回一个 Promise，该 Promise 解析为 undefined。
Navigator.deprecatedReplaceInURN() 实验性: 替换与给定不透明 URN 或 FencedFrameConfig 的内部 url 属性相对应的映射 URL 中的指定字符串。此方法已作为临时措施提供（因此为“已弃用”），以便为围栏框架 URL 启用该替换，帮助广告技术提供商将其现有实现迁移到隐私沙箱 API。
Navigator.getAutoplayPolicy() 实验性: 返回一个值，指示指定的媒体元素、音频上下文或媒体功能“类型”是否允许自动播放。
Navigator.getBattery() 安全上下文: 返回一个 Promise，该 Promise 解析为一个 BatteryManager 对象，该对象返回有关电池充电状态的信息。
Navigator.getGamepads(): 返回一个 Gamepad 对象数组，每个对象对应于连接到设备的一个游戏手柄。
Navigator.getInstalledRelatedApps() 实验性安全上下文: 返回一个 Promise，该 Promise 解析为一个对象数组，表示用户安装的任何相关的本机应用程序或渐进式 Web 应用程序。
Navigator.registerProtocolHandler() 安全上下文: 允许网站将自己注册为给定协议的可能的处理程序。
Navigator.requestMediaKeySystemAccess() 安全上下文: 返回一个 Promise，用于获取 MediaKeySystemAccess 对象。
Navigator.requestMIDIAccess() 安全上下文: 返回一个 Promise，该 Promise 表示对用户系统上的 MIDI 设备的访问请求。
Navigator.sendBeacon(): 用于使用 HTTP 异步从用户代理将少量数据传输到 Web 服务器。
Navigator.setAppBadge() 安全上下文: 在与该应用程序关联的图标上设置徽章，并返回一个 Promise，该 Promise 解析为 undefined。
Navigator.share() 安全上下文: 调用当前平台的本机共享机制。
Navigator.vibrate(): 在支持振动的设备上引起振动。如果振动不支持，则不执行任何操作。
Navigator.unregisterProtocolHandler() 安全上下文: 取消注册作为给定协议的处理程序的网站。

已弃用方法

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

规范

规范
HTML 标准 # the-navigator-object

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。