浏览器

浏览器

状态: 开发中

类型: browser

描述: 应用程序运行的 Web 浏览器。browser.* 属性仅供表示在 Web 浏览器中运行的应用程序的资源使用（无论是在移动设备还是桌面设备上运行）。

其他属性

⚠️ 此实体定义包含没有角色的属性。稳定的实体不得包含没有定义角色的属性。

键Stability需求级别Value Type描述Example Values
browser.brandsDevelopment推荐string[]品牌名称和版本组成的数组，用空格分隔 [1][" Not A;Brand 99", "Chromium 99", "Chrome 99"]
browser.languageDevelopment推荐字符串用户使用浏览器偏好的语言 [2]en; en-US; fr; fr-FR
browser.mobileDevelopment推荐布尔值一个布尔值，如果浏览器运行在移动设备上则为 true [3]
browser.platformDevelopment推荐字符串浏览器运行的平台 [4]Windows; macOS; Android
user_agent.originalStable推荐字符串浏览器提供的完整用户代理字符串 [5]Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36

[1] browser.brands: 此值意图从 UA client hints API (navigator.userAgentData.brands) 中获取。

[2] browser.language: 此值意图从 Navigator API navigator.language 中获取。

[3] browser.mobile: 此值意图从 UA client hints API (navigator.userAgentData.mobile) 中获取。如果不可用，则应将此属性留空。

[4] browser.platform: 该值应取自 UA 客户端提示 API（navigator.userAgentData.platform）。如果不可用，则不应使用旧的 navigator.platform API，并且应将此属性留空，以确保值的一致性。可能值的列表定义在 W3C 用户代理客户端提示规范 中。请注意，其中一些值（并非全部）可能与 os.type 和 os.name 属性 中的值重叠。但是，为保持一致，browser.platform 属性中的值应捕获用户代理提供的确切值。

[5] user_agent.original: 用户代理值应仅从那些无法通过用户代理客户端提示 API 单独检索品牌和平台的浏览器提供。要检索该值，可以使用旧的 navigator.userAgent API。