Sec-CH-UA-Form-Factors header
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Tiêu đề HTTP Sec-CH-UA-Form-Factors request header là một gợi ý máy khách tác nhân người dùng cung cấp thông tin về kiểu dáng thiết bị của tác nhân người dùng.
| Loại tiêu đề | Request header, Client hint |
|---|---|
| Forbidden request header | Có (tiền tố Sec-) |
Cú pháp
Sec-CH-UA-Form-Factors: <form-factor>
Sec-CH-UA-Form-Factors: <form-factor>, …, <form-factor>
Chỉ thị
<form-factor>-
Chuỗi cho biết kiểu dáng thiết bị phổ biến. Tất cả các kiểu dáng có thể áp dụng đều có thể được bao gồm. Ý nghĩa của các giá trị được phép là:
"Desktop"-
Tác nhân người dùng chạy trên máy tính cá nhân.
"Automotive"-
Tác nhân người dùng được nhúng trong phương tiện, nơi người dùng có thể chịu trách nhiệm vận hành phương tiện và có khả năng tương tác hạn chế.
"Mobile"-
Thiết bị nhỏ, hướng cảm ứng thường được người dùng mang theo.
"Tablet"-
Thiết bị hướng cảm ứng lớn hơn
"Mobile"và thường không được mang theo. "XR"-
Thiết bị đắm chìm tăng cường hoặc thay thế môi trường xung quanh người dùng.
"EInk"-
Thiết bị được đặc trưng bởi cập nhật màn hình chậm và độ phân giải màu hạn chế hoặc không có.
"Watch"-
Thiết bị di động với màn hình rất nhỏ (thường dưới 2 inch), được đeo theo cách mà người dùng có thể liếc nhìn nhanh.
Ví dụ
Sử dụng Sec-CH-UA-Form-Factors
Máy chủ yêu cầu tiêu đề Sec-CH-UA-Form-Factors bằng cách bao gồm Accept-CH trong phản hồi cho bất kỳ yêu cầu nào từ máy khách, sử dụng tên của tiêu đề mong muốn làm token:
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Form-Factors
Máy khách có thể chọn cung cấp gợi ý, và thêm tiêu đề Sec-CH-UA-Form-Factors vào các yêu cầu tiếp theo.
Ví dụ: máy khách có thể thêm tiêu đề như sau:
GET /my/page HTTP/1.1
Host: example.site
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Form-Factors: "EInk"
Trong trường hợp này, "EInk" có nghĩa là thiết bị được đặc trưng bởi cập nhật màn hình chậm và độ phân giải màu hạn chế, và do đó các phản hồi có thể khác nhau tùy thuộc vào gợi ý này.
Đặc tả
| Specification |
|---|
| User-Agent Client Hints # sec-ch-ua-form-factors |
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 trên developer.chrome.com