DOM
Navigator 接口代表了用户代理的状态和身份,它允许脚本对其进行查询并注册自身以便执行某些活动。
可以通过 window.navigator 只读属性获取 Navigator 对象。
实例属性
不继承任何属性。
标准属性
- Navigator.audioSession
- : 返回一个 AudioSession 对象,可用于控制 Web 应用程序的音频如何与设备上播放的其他音频交互。
- 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.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值。
- : 返回一个字符串,表示用户的首选语言,通常是浏览器 UI 的语言。如果未知,则返回
- 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。
- : 如果浏览器在导航到 PDF 文件时可以使用它们,返回
- Navigator.permissions
- : 返回一个 Permissions 对象,可以用来查询和更新受权限 API 支持的 API 的权限状态。
- Navigator.preferences
- : 返回文档当前的 PreferenceManager 对象,提供对用户首选项信息的访问。
- 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。
- : 返回浏览器的构建标识符。在现代浏览器中,为了保护隐私,该属性现在返回一个固定的时间戳,例如 Firefox 64 及更高版本中返回
- Navigator.globalPrivacyControl
- : 返回一个布尔值,表示用户是否同意共享或出售他们的信息。
- Navigator.standalone
- : 返回一个布尔值,表示浏览器是否以独立模式运行。仅在 Apple 的 iOS Safari 上可用。
已弃用的属性
- Navigator.activeVRDisplays
- : 返回一个包含所有当前正在呈现(VRDisplay.isPresenting 为
true)的 VRDisplay 对象的数组。
- : 返回一个包含所有当前正在呈现(VRDisplay.isPresenting 为
- 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。
- : 针对给定的不透明 URN 或
- 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。
- : 在 JavaScript 1.2 版本中移除了对数据污染/净化函数的支持,其返回值为
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
