Movatterモバイル変換


[0]ホーム

URL:


  1. 面向开发者的 Web 技术
  2. Web API
  3. Navigator

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in EnglishAlways switch to English

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 对象。

实例属性

不继承任何属性

标准属性

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 值。

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.isPresentingtrue)的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()安全上下文

清除当前应用图标的徽标,并返回一个兑现为undefinedPromise 对象。

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()安全上下文

在与此应用程序关联的图标上设置徽标,并返回一个兑现为undefinedPromise 对象。

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

浏览器兼容性

Help improve MDN

Learn how to contribute

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2026 Movatter.jp