Sec-CH-Prefers-Reduced-Transparency header
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Tiêu đề HTTP Sec-CH-Prefers-Reduced-Transparency request header là một gợi ý máy khách tác nhân người dùng cho biết sở thích của tác nhân người dùng về độ trong suốt giảm thiểu.
Nếu máy chủ báo hiệu cho máy khách thông qua tiêu đề Accept-CH rằng nó chấp nhận Sec-CH-Prefers-Reduced-Transparency, máy khách có thể phản hồi bằng tiêu đề này để cho biết sở thích của người dùng về độ trong suốt giảm thiểu. Máy chủ có thể gửi nội dung phù hợp cho máy khách — ví dụ: CSS hoặc hình ảnh — để giảm độ trong suốt của nội dung.
Tiêu đề này được mô phỏng theo truy vấn media CSS prefers-reduced-transparency.
| Loại tiêu đề | Request header, Client hint |
|---|---|
| Forbidden request header | Có (tiền tố Sec-) |
Cú pháp
Sec-CH-Prefers-Reduced-Transparency: <preference>
Chỉ thị
<preference>-
Sở thích của tác nhân người dùng về độ trong suốt giảm thiểu. Thường được lấy từ cài đặt hệ điều hành cơ bản. Giá trị của chỉ thị này có thể là
no-preferencehoặcreduce.
Ví dụ
Sử dụng Sec-CH-Prefers-Reduced-Transparency
Máy khách thực hiện yêu cầu ban đầu đến máy chủ:
GET / HTTP/1.1
Host: example.com
Máy chủ phản hồi, báo cho máy khách thông qua Accept-CH rằng nó chấp nhận Sec-CH-Prefers-Reduced-Transparency. Trong ví dụ này, Critical-CH cũng được sử dụng, cho biết rằng Sec-CH-Prefers-Reduced-Transparency được coi là gợi ý máy khách quan trọng.
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
Note:
Chúng tôi cũng đã chỉ định Sec-CH-Prefers-Reduced-Transparency trong tiêu đề Vary, để báo cho trình duyệt biết rằng nội dung được phục vụ sẽ khác nhau dựa trên giá trị tiêu đề này — ngay cả khi URL không thay đổi — do đó trình duyệt không nên chỉ sử dụng phản hồi đã được lưu trong bộ nhớ đệm mà nên lưu phản hồi này riêng biệt. Mỗi tiêu đề được liệt kê trong tiêu đề Critical-CH cũng phải có trong tiêu đề Accept-CH và Vary.
Máy khách tự động thử lại yêu cầu (do Critical-CH được chỉ định ở trên), báo cho máy chủ thông qua Sec-CH-Prefers-Reduced-Transparency rằng nó có sở thích của người dùng về độ trong suốt giảm thiểu:
GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Transparency: "reduce"
Máy khách sẽ bao gồm tiêu đề trong các yêu cầu tiếp theo trong phiên hiện tại, trừ khi Accept-CH thay đổi trong các phản hồi để cho biết rằng nó không còn được máy chủ hỗ trợ.
Đặc tả
| Specification |
|---|
| User Preference Media Features Client Hints Headers # sec-ch-prefers-reduced-transparency |
Tương thích trình duyệt
Xem thêm
- Client hints
- User-Agent Client Hints API
Accept-CH- HTTP Caching: Vary và tiêu đề
Vary - Improving user privacy and developer experience with User-Agent Client Hints (developer.chrome.com)