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

Sec-CH-UA-Full-Version-List

· 52CE 我爱测

`Sec-CH-UA-Full-Version-List`** 用户代理客户端提示请求标头提供用户代理的品牌和完整版本信息。

Sec-CH-UA-Full-Version-List 用户代理客户端提示请求标头提供用户代理的品牌和完整版本信息。

<table class="properties"> <tbody> <tr> <th scope="row">标头类型</th> <td> Request header、<a href="/zh-CN/docs/Web/HTTP/Guides/Client_hints">客户端提示</a> </td> </tr> <tr> <th scope="row">Forbidden request header</th> <td>是</td> </tr> </tbody> </table>

Sec-CH-UA-Full-Version-List 标头以逗号分隔的列表提供与每个浏览器关联的品牌的名称和完整版本信息。

品牌是用户代理的商业名称,例如:Chromium、Opera、Google Chrome、Microsoft Edge、Firefox 和 Safari。用户代理可能有多个关联的品牌。例如,Opera、Chrome 和 Edge 都基于 Chromium,并将在 Sec-CH-UA-Full-Version-List 标头中会提供这两个品牌。

因此,标头允许服务器根据共享品牌及其各自特定版本中的特定自定义项(particular customizations)来自定义其响应。

标头可能包含任何位置和任何名称的“假冒”品牌。此功能旨在防止服务器直接拒绝未知用户代理,迫使用户代理在其品牌标识上撒谎。

[!NOTE] 这类似于 Sec-CH-UA,但包含完整的版本号,而不是每个品牌的重要版本号。

语法

用户代理品牌列表中以逗号分隔的品牌列表及其关联的完整版本号。单个条目的语法具有以下格式:

Sec-CH-UA-Full-Version-List: "<brand>";v="<full version>", ...

指令

  • <brand>
    • : 与用户代理相关的品牌,如“Chromium”和“Google Chrome”。 这可能是一个故意不正确的品牌,如 " Not A;Brand" 或 "(Not(A:Brand"(实际值是预期随时间变化且不可预测的)。
  • <full version>
    • : 完整的版本号,例如 98.0.4750.0。

示例

服务器通过在来自客户端的任何请求的响应中包含 Accept-CH 来请求 Sec-CH-UA-Full-Version-List 标头,并使用所需标头的名称作为令牌:

HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Full-Version-List

客户端可以选择提供提示,并将 Sec-CH-UA-Full-Version-List 标头添加到后续请求中,如下所示:

GET /my/page HTTP/1.1
Host: example.site

Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Full-Version-List: " Not A;Brand";v="99.0.0.0", "Chromium";v="98.0.4750.0", "Google Chrome";v="98.0.4750.0"
Sec-CH-UA-Platform: "Linux"

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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