Sec-CH-Prefers-Reduced-Transparency 頭

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

HTTP Sec-CH-Prefers-Reduced-Transparency 請求頭是一個使用者代理客戶端提示,它指示使用者代理對降低透明度的偏好。

如果伺服器透過 Accept-CH 頭向客戶端發出訊號,表明它接受 Sec-CH-Prefers-Reduced-Transparency,則客戶端可以隨後使用此頭進行響應,以指示使用者對降低透明度的偏好。伺服器可以向客戶端傳送適當調整的內容(例如 CSS 或影像),以降低內容的透明度。

此頭是根據 prefers-reduced-transparency 媒體查詢建模的。

頭型別 請求標頭客戶端提示
禁止請求頭 是 (Sec- 字首)

語法

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

指令

<preference>

使用者代理對降低透明度的偏好。這通常取自底層作業系統的設定。此指令的值可以是 no-preferencereduce

示例

使用 Sec-CH-Prefers-Reduced-Transparency

客戶端向伺服器發出初始請求

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-CHVary 頭中。

客戶端自動重試請求(由於上面指定了 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

瀏覽器相容性

另見