ช่วงทดลองใช้การเลิกใช้งาน 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

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

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

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

เว็บไซต์ควรยังคงตรวจสอบการใช้ส่วนหัว 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 เข้าถึงโดเมนของบุคคลที่สามได้อย่างเต็มที่โดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

    • เพิ่มส่วนหัว 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 ที่ลดลงเพื่อทดสอบกรณีการใช้งานและให้ความคิดเห็นก่อนที่จะกลายเป็นลักษณะการทำงานเริ่มต้นใน Chrome

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

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

ช่วงทดลองใช้การเลิกใช้งานการลด User Agent จะทํางานตั้งแต่ Chrome 100 ถึง Chrome 115 Chrome 116 จะเป็นรุ่นแรกที่จะส่งเฉพาะสตริง User Agent ที่ลดขนาดแล้วเท่านั้น

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

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