此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Navigator
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
Navigator 接口代表了用户代理的状态和身份,它允许脚本对其进行查询并注册自身以便执行某些活动。
可以通过window.navigator 只读属性获取Navigator 对象。
In this article
实例属性
不继承任何属性。
标准属性
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只读实验性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只读安全上下文返回一个对
PresentationAPI 的引用。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只读实验性安全上下文返回一个
VirtualKeyboardAPI 的引用,以控制屏幕上的虚拟键盘。Navigator.wakeLock只读安全上下文返回一个
WakeLock接口,你可以使用它来请求屏幕唤醒锁并防止屏幕变暗、关闭或显示屏幕保护程序。Navigator.webdriver只读表示用户代理是否受自动化控制。
Navigator.windowControlsOverlay只读安全上下文返回
WindowControlsOverlay接口,该接口暴露了桌面渐进式 Web 应用程序标题栏的几何信息,以及在标题栏发生变化时触发的事件。Navigator.xr只读实验性安全上下文
非标准的属性
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()安全上下文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()安全上下文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> # the-navigator-object> |