大网数据广告活动
Web 标准与前端开发

NavigatorUAData

· 52CE 我爱测

User-Agent Client Hints API 的 **`NavigatorUAData`** 接口返回有关用户的浏览器和操作系统的信息。

User-Agent Client Hints API

User-Agent Client Hints API 的 NavigatorUAData 接口返回有关用户的浏览器和操作系统的信息。

通过调用 Navigator.userAgentData 或 WorkerNavigator.userAgentData 返回此对象的实例。因此,该接口没有构造函数。

[!NOTE] 术语高熵和低熵指的是这些值揭示的有关浏览器的信息量。作为属性返回的值被视为低熵,并且不太可能识别用户。NavigatorUAData.getHighEntropyValues() 返回的值可能会揭示更多信息。因此,这些值是通过 Promise 检索的,从而使浏览器有时间请求用户权限或进行其他检查。

实例属性

  • NavigatorUAData.brands
    • : 返回一个包含浏览器名称和版本的品牌信息的数组。
  • NavigatorUAData.mobile
    • : 如果用户代理在移动设备上运行,则返回 true。
  • NavigatorUAData.platform
    • : 返回用户代理运行所在的平台品牌。

实例方法

  • NavigatorUAData.getHighEntropyValues()
    • : 返回一个 Promise,其兑现为包含用户代理返回的高熵值的字典对象。
  • NavigatorUAData.toJSON()
    • : 一个序列化器,返回 NavigatorUAData 对象的低熵属性的 JSON 表示。

示例

获取浏览器品牌信息

以下示例将 NavigatorUAData.brands 的值打印到控制台。

console.log(navigator.userAgentData.brands);

返回高熵的信息

在以下示例中,使用 NavigatorUAData.getHighEntropyValues() 方法请求大量提示。当 promise 兑现时,此信息将打印到控制台。

navigator.userAgentData
  .getHighEntropyValues([
    "architecture",
    "model",
    "platform",
    "platformVersion",
    "fullVersionList",
  ])
  .then((ua) => {
    console.log(ua);
  });

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。