Dùng thử tính năng Giảm thiểu tác nhân người dùng không dùng nữa

Bản dùng thử việc ngừng sử dụng tính năng Giảm thiểu tác nhân người dùng cho phép các trang web tiếp tục nhận được chuỗi tác nhân người dùng đầy đủ sau khi giảm chuỗi UA. Phiên toà kết thúc vào ngày 23 tháng 9 năm 2023.

Cảnh báo: Thời gian dùng thử không dùng tính năng Giảm thiểu tác nhân người dùng kết thúc vào ngày 23 tháng 9 năm 2023. Thông tin có trong chuỗi Tác nhân người dùng bị giảm bớt kể từ Chrome 101. Trong giai đoạn thử nghiệm việc ngừng sử dụng này, các trang web có thể tiếp tục nhận các phần của chuỗi UA, nhưng giờ đây sẽ phải dựa vào các phương thức khác.

Để thay thế chức năng dựa vào chuỗi Tác nhân người dùng, bạn có thể triển khai API gợi ý ứng dụng tác nhân người dùng.

Trang Gợi ý của ứng dụng tác nhân người dùng cung cấp một số thông tin cơ bản.

Phần còn lại của bài đăng trên blog này sẽ được coi là không dùng nữa.

Kể từ Chrome 101, thông tin có trong chuỗi Tác nhân người dùng (UA) sẽ được giảm bớt bằng phương pháp theo giai đoạn. Những trang web chưa có thời gian di chuyển để ngừng sử dụng chuỗi User-Agent đã thu gọn và chuyển sang phần Gợi ý ứng dụng tác nhân người dùng có thể tham gia thử nghiệm ngừng sử dụng để tiếp tục nhận được chuỗi User-Agent đầy đủ.

Quy trình đăng ký dùng thử tính năng ngừng sử dụng sẽ bắt đầu với Chrome 100 Beta. Việc này sẽ cho phép các trang web nhận được chuỗi Tác nhân người dùng đầy đủ trước bản phát hành Chrome 101, trong đó chuỗi phiên bản nhỏ sẽ bị giảm bớt. Nếu bạn muốn kiểm thử bản dùng thử theo nguyên gốc trên Chrome 100 Beta trước khi bản chính thức ra mắt trên kênh chính thức, hãy nhớ đăng ký và kiểm thử trước ngày phát hành Chrome 100 (hiện dự kiến ra mắt vào ngày 31 tháng 3 năm 2022).

Dưới đây là thông tin tổng quan về bản dùng thử việc ngừng sử dụng và những điều cần biết. Nếu bạn muốn chia sẻ ý kiến phản hồi hoặc gặp vấn đề trong quá trình dùng thử này, hãy cho chúng tôi biết trong kho lưu trữ GitHub về UA.

Ảnh hưởng đối với nhà phát triển web

Bằng cách đăng ký dùng thử tính năng ngừng sử dụng, các trang web sẽ tiếp tục nhận được chuỗi UA đầy đủ trong navigator.userAgent và các giá trị không được giảm trong phương thức getter JavaScript navigator.platform và navigator.appVersion liên quan:

Tiêu đề của yêu cầu HTTP User-Agent
Phương thức getter của JavaScript navigator.userAgent
Phương thức getter của JavaScript navigator.platform
Phương thức getter của JavaScript navigator.appVersion

Các trang web vẫn nên kiểm tra việc sử dụng tiêu đề Tác nhân người dùng và các API liên quan, đồng thời chuẩn bị di chuyển sang Gợi ý ứng dụng tác nhân người dùng (nếu cần) trước khi hết thời gian dùng thử việc ngừng sử dụng. Mục đích là để kết thúc bản dùng thử ngừng sử dụng này sau khi quá trình triển khai tính năng Giảm thiểu tác nhân người dùng hoàn tất.

Làm cách nào để tham gia chương trình dùng thử việc ngừng sử dụng tính năng Giảm thiểu tác nhân người dùng?

Đăng ký dùng thử

Để đăng ký bản dùng thử theo nguyên gốc và nhận mã thông báo cho miền của bạn, hãy truy cập trang dùng thử việc ngừng sử dụng tính năng Giảm thiểu tác nhân người dùng. Nếu bạn là bên thứ ba đăng ký, vui lòng chọn "So khớp bên thứ ba".

Thiết lập

Sau khi bạn đăng ký dùng thử, hãy cập nhật tiêu đề phản hồi HTTP của bạn bằng những thông tin sau:

Thêm Origin-Trial: <ORIGIN TRIAL TOKEN> vào tiêu đề phản hồi HTTP. <ORIGIN TRIAL TOKEN> chứa mã thông báo mà bạn nhận được khi đăng ký bản dùng thử theo nguyên gốc.
Thêm Accept-CH: Sec-CH-UA-Full vào tiêu đề phản hồi HTTP. Việc đặt Accept-CH sẽ chỉ khiến chuỗi User-Agent đầy đủ được gửi trong các yêu cầu tiếp theo đến nguồn gốc.
Nếu chuỗi đầy đủ của Tác nhân người dùng là quan trọng trong yêu cầu đầu tiên, hãy thêm Critical-CH: Sec-CH-UA-Full vào tiêu đề phản hồi HTTP của bạn, ngoài các tiêu đề Accept-CH và Origin-Trial.
Đối với những người tham gia thử nghiệm việc ngừng sử dụng tính năng giảm thiểu, bạn nên cho phép tất cả miền của bên thứ ba truy cập vào chuỗi đầy đủ của Tác nhân người dùng. Nếu không mở rộng quyền truy cập của miền bên thứ ba vào chuỗi User-Agent đầy đủ, thì quyền truy cập đầy đủ của các miền đó sẽ bị chặn, bất kể họ có đăng ký dùng thử ngừng sử dụng hay không. Bạn có thể cho phép chuỗi tác nhân người dùng truy cập đầy đủ vào các miền của bên thứ ba bằng một trong hai tuỳ chọn sau:
- Thêm tiêu đề Permissions-Policy có các miền của bên thứ ba sẽ nhận được chuỗi User-Agent đầy đủ.
  - Để cho phép tất cả các miền của bên thứ ba, hãy thêm Permissions-Policy: ch-ua-full=*.
  - Để cho phép danh sách các miền bên thứ ba có tên, hãy thêm Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
- Thêm một thẻ meta Accept-CH có các miền của bên thứ ba sẽ nhận được chuỗi tác nhân người dùng đầy đủ (chỉ có trong Chrome 100 trở lên).
  - Để cho phép danh sách các miền bên thứ ba có tên, hãy thêm <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
  - Bạn không thể uỷ quyền cho tất cả các miền của bên thứ ba qua * trong thẻ meta.
Tải trang web của bạn trong Chrome 100 trở lên để tiếp tục nhận chuỗi User-Agent đầy đủ.

Bản minh hoạ

Truy cập vào https://uard-ot-demo.glitch.me để xem phần minh hoạ về bản dùng thử (cùng với mã nguồn).

Làm cách nào để xác thực rằng bản dùng thử đang hoạt động?

Để xác thực rằng bản dùng thử theo nguyên gốc đang hoạt động, hãy kiểm tra tiêu đề của yêu cầu và đảm bảo những thông tin sau:

Tiêu đề Tác nhân người dùng chứa phiên bản đầy đủ. Tập dữ liệu này không được chứa bất kỳ giá trị bị giảm nào (có trong danh sách các mẫu chuỗi tác nhân người dùng được rút gọn). Một cách dễ dàng để biết là chuỗi phiên bản nhỏ của Chrome không được là 0.0.0.
Tiêu đề Sec-CH-UA-Full được đặt thành ?1.

Tiêu đề của phản hồi ban đầu chứa mã thử nghiệm ban đầu sẽ có dạng như sau:

Tiêu đề của yêu cầu tiếp theo chứa chuỗi tác nhân người dùng đầy đủ sẽ có dạng như sau:

Làm cách nào để ngừng tham gia thử nghiệm ngừng sử dụng tính năng Giảm thiểu tác nhân người dùng?

Tại một thời điểm cụ thể trong thời gian dùng thử, bạn có thể ngừng tham gia và nhận chuỗi Tác nhân người dùng được rút gọn. Cách ngừng tham gia:

Gửi tiêu đề Accept-CH trong phản hồi HTTP không bao gồm Sec-CH-UA-Full. Lưu ý rằng Accept-CH có giá trị trống là một cách hợp lệ để thực hiện việc này nếu trang web của bạn không yêu cầu bất kỳ Gợi ý ứng dụng nào khác.
Xoá tiêu đề Origin-Trial cho bản dùng thử việc ngừng sử dụng tính năng Giảm thiểu tác nhân người dùng khỏi phản hồi HTTP của bạn.
Nếu được đặt, hãy xoá Sec-CH-UA-Full khỏi tiêu đề Critical-CH trong phản hồi HTTP của bạn.

Bản dùng thử này có gì khác so với các bản dùng thử khác theo nguyên gốc Tác nhân người dùng?

Chrome đang chạy 2 bản dùng thử theo nguyên gốc liên quan đến việc giảm thiểu tác nhân người dùng. Thay đổi đầu tiên là bản dùng thử theo nguyên gốc Giảm tác nhân người dùng, cho phép các trang web nhận chuỗi tác nhân người dùng được rút gọn để kiểm thử các trường hợp sử dụng và đưa ra ý kiến phản hồi trước khi đây là hành vi mặc định trên Chrome.

Lý do thứ hai, được đề cập ở đây, là bản dùng thử ngừng sử dụng dành cho các trang web cần thêm một chút thời gian để chuyển sang User-Agent Client Hints API (API Gợi ý của ứng dụng tác nhân người dùng). API này cho phép các trang web tiếp tục nhận chuỗi User-Agent đầy đủ.

Thời gian dùng thử việc ngừng sử dụng sẽ kéo dài trong bao lâu?

Bản dùng thử không dùng tính năng Giảm thiểu tác nhân người dùng sẽ chạy từ Chrome 100 đến Chrome 115. Chrome 116 sẽ là bản phát hành đầu tiên chỉ gửi chuỗi Tác nhân người dùng rút gọn hoàn toàn.

Làm thế nào để chia sẻ ý kiến phản hồi về bản dùng thử khấu hao để giảm tác nhân người dùng?

Gửi mọi vấn đề hoặc ý kiến phản hồi đến kho lưu trữ GitHub về User-Agent Reduction.