ช่วงทดลองใช้การเลิกใช้งาน User-Agent

การทดลองใช้การเลิกใช้งาน User Agent ช่วยให้เว็บไซต์ได้รับสตริง User Agent แบบเต็มต่อไปหลังจากที่ลดสตริง UA ช่วงทดลองใช้จะสิ้นสุดในวันที่ 23 กันยายน 2023

ตั้งแต่ Chrome 101 เป็นต้นไป ข้อมูลที่มีอยู่ในสตริง User-Agent (UA) จะลดลงด้วยวิธีการแบ่งเป็นระยะ เว็บไซต์ที่ยังไม่มีเวลาเปลี่ยนจากการใช้สตริง User-Agent ที่ลดลงและเปลี่ยนไปใช้คำแนะนำไคลเอ็นต์ User-Agent สามารถเข้าร่วมในการทดลองใช้การเลิกใช้งานเพื่อรับสตริง User-Agent แบบเต็มต่อไป

โดยการลงทะเบียนทดลองใช้การเลิกใช้งานจะเริ่มต้นใน Chrome 100 รุ่นเบต้า เว็บไซต์จะได้รับสตริง User-Agent แบบเต็มก่อนที่จะเปิดตัว Chrome 101 โดยระบบจะลดสตริงเวอร์ชันย่อยลง หากต้องการทดสอบช่วงทดลองใช้จากต้นทางใน Chrome 100 เบต้าก่อนที่จะเปิดตัวในเวอร์ชันเสถียร อย่าลืมลงทะเบียนและทดสอบก่อนวันเปิดตัว Chrome 100 (ปัจจุบันมีกำหนดในวันที่ 31 มีนาคม 2022)

ด้านล่างนี้คือภาพรวมของการทดลองใช้การเลิกใช้งานและสิ่งที่จะเกิดขึ้น หากคุณมีความคิดเห็นที่จะแชร์หรือพบปัญหาตลอดช่วงทดลองใช้นี้ โปรดแจ้งให้เราทราบในที่เก็บ GitHub สำหรับ UA Reduction

การเปลี่ยนแปลงนี้ส่งผลอย่างไรต่อนักพัฒนาเว็บ

เมื่อลงทะเบียนทดลองใช้การเลิกใช้งาน เว็บไซต์จะยังคงได้รับสตริง UA แบบเต็มใน navigator.userAgent และค่าที่ไม่ลดลงใน Getter ของ JavaScript navigator.platform และ navigator.appVersion ที่เกี่ยวข้อง

  • ส่วนหัวของคำขอ HTTP User-Agent
  • โค้ด JavaScript ของ navigator.userAgent
  • โค้ด JavaScript ของ navigator.platform
  • โค้ด JavaScript ของ navigator.appVersion

เว็บไซต์ควรตรวจสอบการใช้งานส่วนหัว User-Agent และ API ที่เกี่ยวข้อง และหากจำเป็น ให้เตรียมพร้อมเพื่อเปลี่ยนไปใช้คำแนะนำของไคลเอ็นต์ User-Agent ก่อนที่ช่วงทดลองใช้การเลิกใช้งานจะสิ้นสุดลง เป้าหมายจะให้ช่วงการทดลองใช้การเลิกใช้งานนี้หมดอายุเมื่อการเปิดตัวการลด User Agent เสร็จสมบูรณ์

ฉันจะเข้าร่วมช่วงทดลองใช้การเลิกใช้งาน User-Agent ได้อย่างไร

ลงทะเบียนทดลองใช้

หากต้องการลงทะเบียนสำหรับช่วงทดลองใช้จากต้นทางและรับโทเค็นสำหรับโดเมน โปรดไปที่หน้าการทดลองใช้การเลิกใช้งาน User Agent ที่ลดลง หากคุณลงทะเบียนของบุคคลที่สาม โปรดตรวจสอบ "การจับคู่ของบุคคลที่สาม"

การตั้งค่า

เมื่อคุณลงทะเบียนทดลองใช้แล้ว ให้อัปเดตส่วนหัวการตอบกลับ HTTP ด้วยข้อมูลต่อไปนี้

  1. เพิ่ม Origin-Trial: <ORIGIN TRIAL TOKEN> ลงในส่วนหัวการตอบกลับ HTTP <ORIGIN TRIAL TOKEN> มีโทเค็นที่คุณได้รับเมื่อลงทะเบียนทดลองใช้จากต้นทาง
  2. เพิ่ม Accept-CH: Sec-CH-UA-Full ลงในส่วนหัวการตอบกลับ HTTP การตั้งค่า Accept-CH จะทำให้ระบบส่งสตริง User-Agent แบบเต็มในคำขอที่ตามมาไปยังต้นทางเท่านั้น
  3. หากสตริง User-Agent แบบเต็มมีความสำคัญในคำขอแรก ให้เพิ่ม Critical-CH: Sec-CH-UA-Full ลงในส่วนหัวการตอบกลับ HTTP นอกเหนือจากส่วนหัว Accept-CH และ Origin-Trial

  4. สำหรับผู้เข้าร่วมช่วงทดลองใช้การเลิกใช้งานการลด เราขอแนะนำให้อนุญาตให้โดเมนบุคคลที่สามทั้งหมดเข้าถึงสตริง User-Agent แบบเต็ม การไม่ขยายสิทธิ์เข้าถึงสตริง User-Agent แบบเต็มของโดเมนบุคคลที่สามจะบล็อกการเข้าถึงสตริง User-Agent อย่างเต็มรูปแบบ ไม่ว่าจะมีการลงทะเบียนทดลองใช้การเลิกใช้งานฟีเจอร์ลดรุ่นของตนหรือไม่ก็ตาม คุณอนุญาตให้เข้าถึงสตริง User-Agent อย่างเต็มรูปแบบในโดเมนของบุคคลที่สามได้โดย 1 จาก 2 ตัวเลือกต่อไปนี้

    • เพิ่มส่วนหัว Permissions-Policy ที่มีโดเมนของบุคคลที่สามซึ่งควรได้รับสตริง User-Agent แบบเต็ม
      • หากต้องการอนุญาตโดเมนของบุคคลที่สามทั้งหมด ให้เพิ่ม Permissions-Policy: ch-ua-full=*
      • หากต้องการอนุญาตรายการโดเมนของบุคคลที่สามที่มีชื่อ ให้เพิ่ม Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com")
    • เพิ่มเมตาแท็ก Accept-CH โดยมีโดเมนของบุคคลที่สามซึ่งควรได้รับสตริง User-Agent แบบเต็ม (ใน Chrome 100 ขึ้นไปเท่านั้น)
      • หากต้องการอนุญาตรายการโดเมนของบุคคลที่สามที่มีชื่อ ให้เพิ่ม <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">
      • มอบสิทธิ์ให้กับโดเมนของบุคคลที่สามทั้งหมดผ่าน * ในเมตาแท็กไม่ได้

  5. โหลดเว็บไซต์ใน Chrome 100 (หรือใหม่กว่า) แล้วรับสตริง User-Agent แบบเต็มต่อไป

การสาธิต

ดูการสาธิตการทดลองใช้ (พร้อมซอร์สโค้ด) ได้ที่ https://uard-ot-demo.glitch.me

ฉันจะตรวจสอบได้อย่างไรว่าการทดลองใช้งานได้

หากต้องการตรวจสอบว่าช่วงทดลองใช้จากต้นทางใช้งานได้ ให้ตรวจสอบส่วนหัวของคำขอและตรวจสอบว่าเป็นไปตามข้อกำหนดต่อไปนี้

  1. ส่วนหัว User-Agent มีเวอร์ชันเต็ม โดยไม่ควรมีค่าที่ลดลง (พบได้ในรายการตัวอย่างสตริง User-Agent ที่ลดลง) วิธีง่ายๆ คือสตริงเวอร์ชันย่อยของ Chrome ต้องไม่เป็น 0.0.0
  2. ตั้งค่าส่วนหัว Sec-CH-UA-Full เป็น ?1

ส่วนหัวของการตอบกลับเริ่มต้นที่มีโทเค็นสำหรับทดลองใช้จากต้นทางควรมีลักษณะดังนี้

ส่วนหัวของคำขอที่ตามมาที่มีสตริง User-Agent แบบเต็มควรมีลักษณะดังนี้

ฉันจะหยุดเข้าร่วมช่วงทดลองใช้การเลิกใช้งาน User-Agent ได้อย่างไร

ในช่วงเวลาหนึ่งๆ ระหว่างช่วงทดลองใช้ คุณสามารถหยุดการเข้าร่วมและรับสตริง User Agent ที่ลดลงได้ วิธีหยุดเข้าร่วม

  1. ส่งส่วนหัว Accept-CH ในการตอบกลับ HTTP ที่ไม่มี Sec-CH-UA-Full โปรดทราบว่า Accept-CH ที่มีค่าว่างเป็นวิธีที่ถูกต้องในการดำเนินการนี้ หากเว็บไซต์ไม่ได้ขอคำแนะนำอื่นๆ จากลูกค้า
  2. นำส่วนหัว Origin-Trial สำหรับช่วงทดลองใช้การเลิกใช้งาน User-Agent ออกจากการตอบกลับ HTTP
  3. หากตั้งค่าไว้ ให้นำ Sec-CH-UA-Full ออกจากส่วนหัว Critical-CH ในการตอบกลับ HTTP

ช่วงทดลองใช้นี้แตกต่างจากช่วงทดลองใช้ User-Agent จากต้นทางอื่นๆ อย่างไร

Chrome กำลังทำช่วงทดลองใช้จากต้นทาง 2 รายการที่เกี่ยวข้องกับการลด User Agent เวอร์ชันแรกคือช่วงทดลองใช้จากต้นทางการลด User Agent ซึ่งอนุญาตให้เว็บไซต์รับสตริง User Agent ที่ลดลงเพื่อทดสอบ Use Case และแสดงความคิดเห็นก่อนที่จะกลายเป็นลักษณะการทำงานเริ่มต้นใน Chrome

อย่างที่ 2 ในที่นี้คือการทดลองการเลิกใช้งานที่มีไว้สำหรับเว็บไซต์ที่ต้องการเวลาเพิ่มเล็กน้อยเพื่อย้ายข้อมูลไปยัง User-Agent Client Hints API เพื่อให้เว็บไซต์รับสตริง User-Agent แบบเต็มต่อไปได้

ช่วงทดลองใช้การเลิกใช้งานจะมีระยะเวลานานเท่าใด

ช่วงทดลองใช้การเลิกใช้งาน User Agent จะเริ่มจาก Chrome 100 ถึง Chrome 115 Chrome 116 จะเป็นรุ่นแรกที่ส่งเฉพาะสตริง User-Agent ที่ลดลงโดยสมบูรณ์เท่านั้น

ฉันจะแชร์ความคิดเห็นเกี่ยวกับการทดลองใช้การลดค่า User-Agent ได้อย่างไร

ส่งปัญหาหรือความคิดเห็นไปยังที่เก็บ GitHub สำหรับ User-Agent Reduction