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 表格僅在瀏覽器中載入

另請參閱