NavigatorUAData

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

注意:此功能在 Web Workers 中可用。

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

通过调用 Navigator.userAgentDataWorkerNavigator.userAgentData 可以获得此对象的实例。因此,此接口没有构造函数。

注意:术语高熵低熵指的是这些值在多大程度上揭示了有关浏览器信息。作为属性返回的值被认为是低熵的,不太可能用于识别用户。通过 NavigatorUAData.getHighEntropyValues() 返回的值可能包含更多信息。因此,这些值通过 Promise 检索,以便浏览器有时间请求用户许可或进行其他检查。

实例属性

返回一个包含浏览器名称和版本的品牌信息数组。

如果用户代理正在移动设备上运行,则返回 true

返回用户代理正在运行的平台品牌。

实例方法

返回一个 Promise,该 Promise 解析为一个字典对象,包含用户代理返回的高熵值。

一个序列化器,它返回 NavigatorUAData 对象低熵属性的 JSON 表示。

示例

获取品牌

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

js
console.log(navigator.userAgentData.brands);

返回高熵值

在下面的示例中,使用 NavigatorUAData.getHighEntropyValues() 方法请求了许多提示。当 Promise 解析后,这些信息将被打印到控制台。

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

规范

规范
用户代理客户端提示
# navigatoruadata

浏览器兼容性

另见