top
logo
custom icon资源HOT
custom icon功能概览
language-switch
Client Hints 是一组 HTTP 标头和 JavaScript API,允许网络浏览器向网络服务器发送有关客户端设备和浏览器的详细信息。它们旨在成为 User-Agent 的后继者,并为网络服务器提供一种标准化的方式来优化客户端内容,而无需依赖不可靠的基于 User-Agent 字符串的检测或浏览器指纹识别技术
User-Agent 字符串
user-Agent
loadingloading...
User-Agent Client Hints (JavaScript API)
API 支持
loadingloading...
架构
loadingloading...
bitness
loadingloading...
品牌 (浏览器品牌)
loadingloading...
完整版本列表
loadingloading...
mobile
loadingloading...
model
loadingloading...
platform
loadingloading...
平台版本
loadingloading...
用户代理完整版本
loadingloading...
WOW64 (64 位 Windows 上的 32 位)
loadingloading...
请求标头 (User-Agent Client Hints)
sec-ch-ua
loadingloading...
sec-ch-ua-platform
loadingloading...
sec-ch-ua-mobile
loadingloading...
sec-ch-ua-full-version
loadingloading...
sec-ch-ua-platform-version
loadingloading...
sec-ch-ua-full-version-list
loadingloading...
sec-ch-ua-arch
loadingloading...
sec-ch-ua-bitness
loadingloading...
sec-ch-ua-wow64
loadingloading...
sec-ch-ua-model
loadingloading...
sec-ch-save-data
loadingloading...
sec-ch-width
loadingloading...
sec-ch-viewport-width
loadingloading...
viewport-width
loadingloading...
sec-ch-viewport-height
loadingloading...
sec-ch-dpr
loadingloading...
dpr
loadingloading...
sec-ch-device-memory
loadingloading...
device-memory
loadingloading...
sec-ch-rtt
loadingloading...
sec-ch-ect
loadingloading...
ect
loadingloading...
sec-ch-prefers-color-scheme
loadingloading...
sec-ch-prefers-reduced-motion
loadingloading...
sec-ch-prefers-reduced-transparency
loadingloading...
sec-ch-prefers-contrast
loadingloading...
sec-ch-forced-colors
loadingloading...
sec-ch-ua-form-factors
loadingloading...
已知 Client Hints 标头(参考)
  • 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
    以 CSS 像素为单位提供图像资源请求的布局宽度。
  • 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
    指示用户代理是否启用了强制颜色模式,在该模式中,它会在页面上强制使用用户选择的有限调色板。
Client Hints 是什么?和 User-Agent 有什么区别?
Client Hints 是一组以 sec-ch-ua 开头的 HTTP 请求头和配套 JS API,用来传递浏览器、平台、设备形态等信息。区别在于 UA 是一次性把一长串全发过去,Client Hints 则由服务器按需索取,字段更结构化,也更容易做粒度控制。
常见的 Client Hints 字段有哪些,分别代表什么?
低熵的三个默认就会发送:sec-ch-ua 表示浏览器品牌与大版本,sec-ch-ua-platform 表示操作系统平台,sec-ch-ua-mobile 表示是否移动设备。而完整版本号、平台版本、架构、设备型号这些高熵字段,需要服务器明确申请,或由页面通过 navigator.userAgentData.getHighEntropyValues() 主动获取。
为什么有的网站拿到的 Client Hints 信息比别人多?
因为高熵字段是要了才给的机制。服务器需要在响应头里用 Accept-CH 声明想要哪些字段,浏览器下次请求才会带上。所以同一台设备在不同站点被采集到的详细程度可能不一样,取决于对方申请了什么。