Uji coba penghentian penggunaan Pengurangan Agen Pengguna

Uji coba penghentian penggunaan Pengurangan Agen Pengguna memungkinkan situs terus menerima string Agen Pengguna penuh setelah pengurangan string UA. Uji coba ini berakhir pada 23 September 2023.

Mulai Chrome 101, informasi yang tersedia di string Agen Pengguna (UA) akan dikurangi menggunakan pendekatan bertahap. Situs yang belum memiliki waktu untuk bermigrasi dari penggunaan string Agen Pengguna yang dikurangi dan beralih ke Petunjuk Klien Agen Pengguna dapat mengikuti uji coba penghentian penggunaan untuk terus menerima string Agen Pengguna lengkap.

Pendaftaran untuk uji coba penghentian penggunaan akan dimulai dengan Chrome 100 Beta. Perubahan ini akan memungkinkan situs menerima string Agen Pengguna lengkap sebelum rilis Chrome 101, dengan pengurangan string versi minor. Jika Anda ingin menguji uji coba origin di Chrome 100 Beta sebelum diluncurkan ke saluran stabil, pastikan Anda mendaftar dan melakukan pengujian sebelum tanggal rilis Chrome 100 (saat ini dijadwalkan pada 31 Maret 2022).

Berikut adalah ringkasan uji coba penghentian penggunaan dan proses selanjutnya. Jika Anda memiliki masukan untuk disampaikan atau mengalami masalah selama uji coba ini, beri tahu kami di repositori GitHub Pengurangan UA.

Apa pengaruhnya bagi developer web?

Dengan mendaftar ke uji coba penghentian penggunaan, situs akan terus menerima string UA lengkap di navigator.userAgent dan nilai yang tidak dikurangi dalam pengambil JavaScript navigator.platform dan navigator.appVersion terkait:

Header permintaan HTTP User-Agent
Pengambil JavaScript navigator.userAgent
Pengambil JavaScript navigator.platform
Pengambil JavaScript navigator.appVersion

Situs tetap harus mengaudit penggunaan header Agen Pengguna dan API terkait, dan jika perlu bersiap untuk bermigrasi ke Petunjuk Klien Agen Pengguna sebelum uji coba penghentian berakhir. Tujuannya adalah mengakhiri uji coba penghentian ini setelah peluncuran Pengurangan Agen Pengguna selesai.

Bagaimana cara berpartisipasi dalam uji coba penghentian penggunaan Pengurangan Agen Pengguna?

Mendaftar uji coba

Untuk mendaftar ke uji coba origin dan mendapatkan token untuk domain Anda, buka halaman uji coba penghentian penggunaan Pengurangan Agen Pengguna. Jika Anda adalah pihak ketiga yang mendaftar, centang 'Pencocokan pihak ketiga'.

Penyiapan

Setelah mendaftar ke uji coba, perbarui header respons HTTP Anda dengan kode berikut:

Tambahkan Origin-Trial: <ORIGIN TRIAL TOKEN> ke header respons HTTP Anda. <ORIGIN TRIAL TOKEN> berisi token yang Anda dapatkan saat mendaftar ke uji coba origin.
Tambahkan Accept-CH: Sec-CH-UA-Full ke header respons HTTP Anda. Menyetel Accept-CH hanya akan menyebabkan string Agen Pengguna lengkap dikirim pada permintaan berikutnya ke asal.
Jika string Agen Pengguna lengkap sangat penting pada permintaan pertama, tambahkan Critical-CH: Sec-CH-UA-Full ke header respons HTTP Anda, selain header Accept-CH dan Origin-Trial.
Untuk peserta yang bergabung dalam uji coba penghentian penggunaan pengurangan, sebaiknya izinkan semua domain pihak ketiga mengakses string Agen Pengguna lengkap. Jika gagal memperluas akses domain pihak ketiga ke string Agen Pengguna lengkap, akses string Agen Pengguna akan diblokir secara penuh, terlepas dari pendaftaran uji coba penghentian penggunaan domain pihak ketiga tersebut. Anda dapat mengizinkan akses string Agen Pengguna penuh ke domain pihak ketiga dengan salah satu dari dua opsi berikut:
- Tambahkan header Permissions-Policy dengan domain pihak ketiga yang akan menerima string Agen Pengguna lengkap.
  - Untuk mengizinkan semua domain pihak ketiga, tambahkan Permissions-Policy: ch-ua-full=*.
  - Untuk mengizinkan daftar domain pihak ketiga yang diberi nama, tambahkan Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
- Tambahkan tag meta Accept-CH dengan domain pihak ketiga yang akan menerima string Agen Pengguna lengkap (hanya di Chrome 100 dan yang lebih baru).
  - Untuk mengizinkan daftar domain pihak ketiga yang diberi nama, tambahkan <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
  - Anda tidak dapat mendelegasikan ke semua domain pihak ketiga melalui * di tag meta.
Muat situs Anda di Chrome 100 (atau yang lebih baru) dan terus terima string Agen Pengguna lengkap.

Demo

Lihat https://uard-ot-demo.glitch.me untuk melihat demonstrasi uji coba tersebut (beserta kode sumbernya).

Bagaimana cara memvalidasi bahwa uji coba tersebut berfungsi?

Untuk memvalidasi bahwa uji coba origin berfungsi, periksa header permintaan dan pastikan hal berikut:

Header Agen Pengguna berisi versi lengkap. URL tidak boleh berisi nilai yang dikurangi (terdapat dalam daftar contoh string Agen Pengguna yang dikurangi). Cara mudah untuk mengetahuinya adalah bahwa string versi minor Chrome tidak boleh 0.0.0.
Header Sec-CH-UA-Full disetel ke ?1.

Header respons awal yang berisi token uji coba origin akan terlihat seperti ini:

Header permintaan berikutnya yang berisi string Agen Pengguna lengkap akan terlihat seperti ini:

Bagaimana cara berhenti berpartisipasi dalam uji coba penghentian penggunaan Pengurangan Agen Pengguna?

Anda dapat berhenti berpartisipasi dan menerima string Agen Pengguna yang dikurangi selama periode uji coba. Untuk berhenti berpartisipasi:

Kirim header Accept-CH dalam respons HTTP yang tidak menyertakan Sec-CH-UA-Full. Perhatikan bahwa Accept-CH dengan nilai kosong adalah cara yang valid untuk melakukannya jika situs Anda tidak meminta Petunjuk Klien lainnya.
Hapus header Origin-Trial untuk uji coba penghentian penggunaan Pengurangan Agen Pengguna dari respons HTTP Anda.
Jika disetel, hapus Sec-CH-UA-Full dari header Critical-CH di respons HTTP Anda.

Apa perbedaan uji coba ini dengan uji coba origin Agen Pengguna lainnya?

Chrome menjalankan dua uji coba origin yang terkait dengan pengurangan Agen Pengguna. Yang pertama adalah uji coba origin Pengurangan Agen Pengguna, yang memungkinkan situs menerima string agen pengguna yang dikurangi untuk menguji kasus penggunaannya dan memberikan masukan sebelum menjadi perilaku default di Chrome.

Yang kedua, yang dirujuk di sini, adalah uji coba penghentian yang ditujukan untuk situs yang memerlukan lebih banyak waktu untuk bermigrasi ke User-Agent Client Hints API. Langkah ini memungkinkan situs untuk terus menerima string Agen Pengguna lengkap.

Berapa lama uji coba penghentian penggunaan akan berlangsung?

Uji coba penghentian penggunaan Pengurangan Agen Pengguna akan berjalan dari Chrome 100 ke Chrome 115. Chrome 116 akan menjadi rilis pertama tempat hanya string Agen Pengguna yang dikurangi sepenuhnya yang dikirim.

Bagaimana cara memberikan masukan untuk uji coba penghentian penggunaan Agen Pengguna?

Kirim masalah atau masukan apa pun ke repositori GitHub Pengurangan Agen Pengguna.