Uji coba penghentian penggunaan Pengurangan Agen Pengguna
bookmark_border Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Mulai Chrome 101, informasi yang tersedia di string Agen Pengguna (UA) akan dikurangi menggunakan pendekatan bertahap. Situs yang belum sempat bermigrasi dari penggunaan string Agen Pengguna yang dikurangi dan beralih ke Client Hints Agen Pengguna dapat berpartisipasi dalam uji coba penghentian penggunaan untuk terus menerima string Agen Pengguna lengkap.

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

Berikut adalah ringkasan uji coba penghentian dan hal yang akan terjadi. Jika Anda memiliki masukan untuk dibagikan atau mengalami masalah selama uji coba ini, beri tahu kami di repositori GitHub Pengurangan UA.

Apa artinya ini 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 di 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 harus tetap mengaudit penggunaan header User-Agent dan API terkait, dan jika perlu, bersiaplah untuk bermigrasi ke Petunjuk Klien User-Agent sebelum uji coba penghentian penggunaan berakhir. Tujuannya adalah untuk menghentikan uji coba penghentian ini setelah peluncuran Pengurangan Agen Pengguna selesai.

Bagaimana cara berpartisipasi dalam uji coba penghentian Pengurangan Agen Pengguna?

Mendaftar untuk uji coba

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

Penyiapan

Setelah mendaftar untuk uji coba, perbarui header respons HTTP dengan hal 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. Menetapkan Accept-CH hanya akan menyebabkan string Agen Pengguna lengkap dikirim pada permintaan berikutnya ke origin.
Jika string User-Agent 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 pengurangan, sebaiknya izinkan semua domain pihak ketiga mengakses string Agen Pengguna lengkap. Kegagalan untuk memperluas akses domain pihak ketiga ke string Agen Pengguna lengkap akan memblokir akses string Agen Pengguna lengkap mereka, terlepas dari pendaftaran uji coba penghentian pengurangan mereka sendiri. 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 menerima string Agen Pengguna lengkap.

Demo

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

Bagaimana cara memvalidasi bahwa uji coba berfungsi?

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

Header User-Agent berisi versi lengkap. String ini tidak boleh berisi nilai yang dikurangi (ditemukan dalam daftar contoh string Agen Pengguna yang dikurangi). Cara mudah untuk mengetahuinya adalah string versi minor Chrome tidak boleh 0.0.0.
Header Sec-CH-UA-Full ditetapkan ke ?1.

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

Header permintaan berikutnya yang berisi string User-Agent lengkap akan terlihat seperti:

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

Pada waktu tertentu selama uji coba, Anda dapat berhenti berpartisipasi dan menerima string Agen Pengguna yang dipersingkat. 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 Client Hints lainnya.
Hapus header Origin-Trial untuk uji coba penghentian penggunaan Pengurangan Agen Pengguna dari respons HTTP Anda.
Jika ditetapkan, 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 penggunaan yang ditujukan untuk situs yang memerlukan waktu lebih lama untuk bermigrasi ke User-Agent Client Hints API. Hal ini memungkinkan situs terus menerima string Agen Pengguna lengkap.

Berapa lama uji coba penghentian penggunaan akan berlangsung?

Uji coba penghentian Pengurangan Agen Pengguna akan berjalan dari Chrome 100 hingga Chrome 115. Chrome 116 akan menjadi rilis pertama yang hanya mengirimkan string Agen Pengguna yang telah dikurangi sepenuhnya.

Bagaimana cara memberikan masukan untuk uji coba depresiasi Pengurangan Agen Pengguna?

Kirimkan masalah atau masukan apa pun ke repositori GitHub Pengurangan User-Agent.