Sec-CH-UA-Full-Version-List 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-UA-Full-Version-List 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ề thương hiệu và phiên bản đầy đủ của tác nhân người dùng.
Tiêu đề Sec-CH-UA-Full-Version-List cung cấp thương hiệu và thông tin phiên bản đầy đủ cho mỗi thương hiệu liên quan đến trình duyệt, trong một danh sách phân cách bằng dấu phẩy.
Tiêu đề có thể bao gồm các thương hiệu "giả" ở bất kỳ vị trí nào và với bất kỳ tên nào. Đây là tính năng được thiết kế để ngăn máy chủ từ chối các tác nhân người dùng không quen biết ngay lập tức, buộc các tác nhân người dùng phải nói dối về danh tính thương hiệu của họ.
Note:
Tiêu đề này tương tự Sec-CH-UA, nhưng bao gồm số phiên bản đầy đủ thay vì số phiên bản quan trọng cho mỗi thương hiệu.
| Loại tiêu đề | Request header, Client hint |
|---|---|
| Forbidden request header | Có (tiền tố Sec-) |
Cú pháp
Sec-CH-UA-Full-Version-List: "<brand>";v="<full version>", …
Giá trị là danh sách phân cách bằng dấu phẩy của các thương hiệu trong danh sách thương hiệu tác nhân người dùng, và số phiên bản đầy đủ liên quan của chúng.
Chỉ thị
<brand>-
Thương hiệu liên quan đến tác nhân người dùng, như "Chromium", "Google Chrome". Đây có thể là thương hiệu sai cố ý như
" Not A;Brand"hoặc"(Not(A:Brand"(giá trị thực tế dự kiến sẽ thay đổi theo thời gian và không thể đoán trước). <full version>-
Số phiên bản đầy đủ, chẳng hạn 98.0.4750.0.
Mô tả
Thương hiệu là tên thương mại của tác nhân người dùng như: Chromium, Opera, Google Chrome, Microsoft Edge, Firefox, và Safari.
Một tác nhân người dùng có thể có một số thương hiệu liên quan.
Ví dụ: Opera, Chrome, và Edge đều dựa trên Chromium, và sẽ cung cấp cả hai thương hiệu trong tiêu đề Sec-CH-UA-Full-Version-List.
Tiêu đề cho phép máy chủ tùy chỉnh phản hồi dựa trên cả thương hiệu chung và các tùy chỉnh cụ thể trong các bản build tương ứng của chúng.
Ví dụ
Sử dụng Sec-CH-UA-Full-Version-List
Máy chủ yêu cầu tiêu đề Sec-CH-UA-Full-Version-List 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-Full-Version-List
Máy khách có thể chọn cung cấp gợi ý, và thêm tiêu đề Sec-CH-UA-Full-Version-List vào các yêu cầu tiếp theo, như sau:
GET /my/page HTTP/1.1
Host: example.site
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Full-Version-List: " Not A;Brand";v="99.0.0.0", "Chromium";v="98.0.4750.0", "Google Chrome";v="98.0.4750.0"
Sec-CH-UA-Platform: "Linux"
Đặc tả
| Specification |
|---|
| User-Agent Client Hints # sec-ch-ua-full-version-list |
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)