Sec-CH-Prefers-Reduced-Transparency

实验性: 这是一个 实验性技术
在生产环境中使用之前，请仔细查看 浏览器兼容性表。

安全上下文: 此功能仅在 安全上下文 (HTTPS) 中可用，在某些或所有 支持的浏览器 中可用。

Sec-CH-Prefers-Reduced-Transparency 用户代理客户端提示 请求头指示用户代理对减少透明度的偏好。

如果服务器通过 Accept-CH 头部向客户端发出信号，表明它接受 Sec-CH-Prefers-Reduced-Transparency，则客户端可以使用此头部来指示用户对减少透明度的偏好。服务器可以向客户端发送适当调整后的内容——例如，CSS 或图像——以降低内容的透明度。

此头部基于 prefers-reduced-transparency 媒体查询。

头部类型 请求头部，客户端提示
禁止的头部名称 是

语法

http
Sec-CH-Prefers-Reduced-Transparency: <preference>

指令

<preference>

用户代理对减少透明度的偏好。这通常取自底层操作系统的设置。此指令的值可以是 no-preference 或 reduce。

示例

客户端向服务器发出初始请求

http
GET / HTTP/1.1
Host: example.com

服务器做出响应，通过 Accept-CH 告诉客户端它接受 Sec-CH-Prefers-Reduced-Transparency。在此示例中，Critical-CH 也被使用，表明 Sec-CH-Prefers-Reduced-Transparency 被认为是 关键客户端提示。

http
HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Transparency
Vary: Sec-CH-Prefers-Reduced-Transparency
Critical-CH: Sec-CH-Prefers-Reduced-Transparency

注意: 我们还在 Vary 头部中指定了 Sec-CH-Prefers-Reduced-Transparency，以指示浏览器提供的內容会根据此头部值而不同——即使 URL 保持不变——因此浏览器不应只是使用现有的缓存响应，而应将此响应单独缓存。Critical-CH 头部中列出的每个头部也应该出现在 Accept-CH 和 Vary 头部中。

客户端自动重试请求（由于上面指定了 Critical-CH），通过 Sec-CH-Prefers-Reduced-Transparency 告诉服务器它对减少透明度有用户偏好

http
GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Transparency: "reduce"

除非 Accept-CH 在响应中发生变化以表明服务器不再支持它，否则客户端将在当前会话的后续请求中包含此头部。

规范

规范
用户偏好媒体功能客户端提示头部
# sec-ch-prefers-reduced-transparency

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅