首页 > Client Hints

Client Hints

Client Hints 是一组 HTTP 标头和 JavaScript API,允许网络浏览器向网络服务器发送有关客户端设备和浏览器的详细信息。它们旨在成为 User-Agent 的后继者,并为网络服务器提供一种标准化的方式来优化客户端内容,而无需依赖不可靠的基于 User-Agent 字符串的检测或浏览器指纹识别技术

HTTP User-Agent
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36

Client Hints JavaScript API

API Support
True
architecture
x86
bitness
64
brands
[ { "brand": "Chromium", "version": "142" }, { "brand": "Google Chrome", "version": "142" }, { "brand": "Not_A Brand", "version": "99" } ]
formFactors
[ { "brand": "Chromium", "version": "142.0.7444.176" }, { "brand": "Google Chrome", "version": "142.0.7444.176" }, { "brand": "Not_A Brand", "version": "99.0.0.0" } ]
mobile
false
model
""
platform
Windows
platformVersion
10.0.0
uaFullVersion
142.0.7444.176
wow64
false

Client Hints HTTP Headers

Client Hints 尚未完全标准化,部分浏览器尚未支持,且由客户端发送,可能出现因缓存或客户端未发送而未接收到值的情况。
sec-ch-ua
"Chromium";v="142", "Google Chrome";v="142", "Not_A Brand";v="99"
sec-ch-ua-platform
"macOS"
sec-ch-ua-mobile
?0
Sec-CH-UA 代表用户代理的品牌和版本
Sec-CH-UA-Full-Version 表示用户代理的完整版本(已弃用,替换成 Sec-CH-UA-Full-Version-List
Sec-CH-UA-Full-Version-List 代表其品牌列表中每个品牌的完整版本。
Sec-CH-UA-Platform 表示给定用户代理正在执行的平台。
Sec-CH-UA-Platform-Version 表示给定用户代理正在执行的平台版本。
Sec-CH-UA-Arch 表示给定用户代理正在执行的平台的架构。
Sec-CH-UA-Bitness 表示给定用户代理正在执行的平台架构的位数。
Sec-CH-UA-WoW64 用于检测用户代理二进制文件是否在 64 位 Windows 上以 32 位模式运行。
Sec-CH-UA-Model 表示正在执行给定用户代理的设备。
Sec-CH-UA-Mobile 用于检测用户代理是否偏向“移动”用户体验。
Sec-CH-UA-Form-Factors 表示设备的外形尺寸,历史上表示为 User-Agent 字符串中的 <deviceCompat> 令牌。
Sec-CH-Lang (或 Lang)代表用户的语言偏好。
Sec-CH-Save-Data (或 Save-Data)代表用户代理减少数据使用的偏好。
Sec-CH-Width 向服务器提供图像的布局宽度。
Sec-CH-Viewport-Width (或Viewport-Width)是 CSS 像素中用户视口的宽度。
Sec-CH-Viewport-Height 表示用户代理的当前视口高度。
Sec-CH-DPR (或DPR)报告用户屏幕的物理像素与 CSS 像素的比例。
Sec-CH-Device-Memory (或Device-Memory)显示当前设备大约有多少内存(以 GiB 为单位)。由于此信息可用于识别用户,因此 的值Device-Memory故意取得很粗略。有效值为0.25、0.5、1、2、4和8。
Sec-CH-RTT (或RTT)提供应用层的近似往返时间(以毫秒为单位)。RTT与传输层 RTT 不同,提示包括服务器处理时间。 的值RTT四舍五入到最接近的 25 毫秒以防止指纹识别。
Sec-CH-Downlink (或Downlink)以兆比特每秒 (Mbps) 表示,显示用户连接的大致下行速度。该值四舍五入为最接近 25 千比特每秒的倍数。因为再次进行指纹识别。
Sec-CH-ECT (或ECT)代表有效连接类型。其值是连接类型的枚举列表之一,每个列表描述 RTT 和下行链路值在指定范围内的连接。 的有效ECT值为4g、3g、2g和slow-2g。
Sec-CH-Prefers-Color-Scheme 代表用户喜欢的配色方案。
Sec-CH-Prefers-Reduced-Motion 用于检测用户是否要求系统最小化其使用的动画或动作量。
Sec-CH-Prefers-Reduced-Transparency 用于检测用户是否要求系统最小化其使用的透明或半透明层效果的数量。
Sec-CH-Prefers-Contrast 用于检测用户是否要求以更高(或更低)的对比度呈现网页内容。
Sec-CH-Forced-Colors 用于检测用户代理是否启用了强制颜色模式,在该模式中,它会在页面上强制使用用户选择的有限调色板。