แก้ปัญหาช่วงทดลองใช้จากต้นทางของ Chrome

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

เช็กลิสต์

หากต้องการแก้ปัญหาช่วงทดลองใช้จากต้นทาง ให้ทำตามปัญหาแต่ละข้อด้านล่างโดยใช้ลิงก์ที่ให้ไว้




















ลองใช้เลย!

การสาธิตด้านล่างแสดงวิธีระบุโทเค็นช่วงทดลองใช้จากต้นทางและสิทธิ์เข้าถึงฟีเจอร์ช่วงทดลองใช้

  • ot-meta.glitch.me: โทเค็นในเมตาแท็ก origin-trial
  • ot-header.glitch.me: โทเค็นในส่วนหัวการตอบกลับ Origin-Trial
  • ot-3p.glitch.me: โทเค็นที่สคริปต์ของบุคคลที่สามแทรก
  • ot-iframe.glitch.me: ฟีเจอร์ช่วงทดลองใช้จากต้นทางที่เข้าถึงได้ใน iframe
  • ot-iframe-3p.glitch.me: ตัวอย่าง iframe แบบข้ามต้นทาง

ใช้เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome เพื่อตรวจสอบโทเค็น

ใน Chrome 93 DevTools จะแสดงข้อมูลการทดลองใช้ต้นทางในแผงแอปพลิเคชันของเฟรมที่เลือก

ข้อมูลการทดลองใช้ต้นทางของ
Chrome DevTools ในแผงแอปพลิเคชัน

ขยายเฟรมบนสุดเพื่อตรวจสอบโทเค็นช่วงทดลองใช้จากต้นทางที่พร้อมใช้งานสำหรับเฟรมย่อย ตัวอย่างเช่น สำหรับหน้าสาธิตที่ ot-iframe.glitch.me คุณจะเห็นว่าหน้าเว็บใน iframe มีโทเค็นให้

เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome 
  แผงแอปพลิเคชันที่แสดงโทเค็นช่วงทดลองใช้จากต้นทางสำหรับหน้าใน iframe

  • สถานะโทเค็น: ดูว่าหน้าเว็บมีโทเค็นที่ถูกต้องหรือไม่ โปรดทราบว่าสำหรับช่วงทดลองใช้จากต้นทางบางรายการ อาจมีปัจจัยอื่นๆ เช่น ข้อจำกัดด้านภูมิศาสตร์ ซึ่งหมายความว่าฟีเจอร์ช่วงทดลองใช้จากต้นทางจะไม่พร้อมใช้งาน แม้จะมีโทเค็นที่ถูกต้องแล้วก็ตาม รหัสสถานะเครื่องมือสำหรับนักพัฒนาเว็บใน Chrome อธิบายความหมายของแต่ละรหัสสำหรับช่วงทดลองใช้จากต้นทาง
  • ต้นทาง: ต้นทางเว็บที่ลงทะเบียนสำหรับโทเค็นนั้น
  • เวลาหมดอายุ: วันที่/เวลาหมดอายุสูงสุด (ล่าสุด) ที่เป็นไปได้สำหรับโทเค็น ซึ่งโดยปกติจะตรงกับช่วงสิ้นสุดระยะเวลาทดลองใช้ ซึ่งไม่เหมือนกับวันที่ "จนถึงวันที่" ที่ถูกต้องของโทเค็นที่แสดงใน My Registrations ซึ่งจะแสดงระยะเวลาที่โทเค็นยังใช้ได้ในปัจจุบันและขยายเวลาได้
  • ข้อจำกัดการใช้งาน: ขีดจำกัดการใช้งานซึ่งกำหนดได้สำหรับช่วงทดลองใช้บางรายการ
  • บุคคลที่สาม: ระบุว่ามีการเปิดใช้การจับคู่บุคคลที่สาม สำหรับโทเค็นหรือไม่ ใช้ได้กับช่วงทดลองใช้จากต้นทางบางรายการ ซึ่งจำเป็นต้องมีการเข้าถึงฟีเจอร์ช่วงทดลองใช้ในหลายเว็บไซต์จากสคริปต์ของบุคคลที่สาม
  • จับคู่โดเมนย่อย: จะเปิดใช้การจับคู่โดเมนย่อยสำหรับโทเค็นหรือไม่ ซึ่งจะช่วยให้ทดสอบฟีเจอร์ช่วงทดลองใช้จากต้นทางได้กับโดเมนย่อยหลายโดเมนของต้นทาง โดยไม่ต้องใช้โทเค็นที่แตกต่างกันสำหรับแต่ละโดเมนย่อย

เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome จะแสดงคำเตือนถัดจากชื่อการทดลองใช้หากผู้ใช้ปัจจุบันไม่พร้อมใช้งาน โทเค็นหมดอายุ หรือหากมีข้อจำกัดอื่นๆ

ข้อมูลการทดลองใช้ต้นทางใน Chrome DevTools ในแผงแอปพลิเคชันที่แสดงโทเค็นที่หมดอายุ

รหัสสถานะเครื่องมือสำหรับนักพัฒนาเว็บใน Chrome

  • หมดอายุแล้ว: โทเค็นผ่านวันที่หมดอายุแล้ว โทเค็นดังกล่าวจะต้องได้รับการต่ออายุ เพื่อสร้างโทเค็นใหม่ที่มีวันที่หมดอายุใหม่
    ซอร์สโค้ด

  • FeatureDisabled: ช่วงทดลองใช้ถูกปิดใช้อยู่
    ซอร์สโค้ด

  • FeatureDisabledForUser: โทเค็นนี้ได้รับการกำหนดให้ปิดใช้สำหรับผู้ใช้ปัจจุบันผ่านข้อจำกัดการใช้งานทางเลือก โปรดดูส่วน "การยกเว้นส่วนย่อยของผู้ใช้" ของเอกสารการออกแบบ
    ซอร์สโค้ด 1
    ซอร์สโค้ด 2

  • ไม่ปลอดภัย: ต้นทางของคำขอไม่ปลอดภัย และไม่มีการเปิดใช้ช่วงทดลองใช้สำหรับต้นทางที่ไม่ปลอดภัย ดังที่อธิบายไว้ในโค้ดเครื่องมือตรวจสอบโทเค็นการทดลองใช้ต้นทาง "สำหรับโทเค็นของบุคคลที่สาม ทั้งต้นทางปัจจุบันและต้นทางสคริปต์ต้องปลอดภัย การจับคู่โดเมนย่อยอาจทำให้ต้นทางของโทเค็นไม่ตรงกันทั้งหมดกับต้นทางสคริปต์ที่ระบุ และผลการค้นหาไม่ได้บอกว่ามีต้นทางใดที่ตรงกัน ซึ่งหมายความว่าไม่ใช่การค้นหาโดยตรงเพื่อหาต้นทางของสคริปต์ที่เหมาะสม มีทางลัดที่ขึ้นอยู่กับจำนวนต้นทางสคริปต์ที่ระบุเพื่อหลีกเลี่ยงการเปรียบเทียบต้นทางทั้งหมดซ้ำ ซึ่งต้องมีอย่างน้อย 1 รายการ ไม่อย่างนั้นโทเค็นของบุคคลที่สามจะตรวจสอบไม่สำเร็จ"
    ซอร์สโค้ด

  • InvalidSignature: โทเค็นมีลายเซ็นที่ไม่ถูกต้องหรือผิดรูปแบบ
    ซอร์สโค้ด

  • มีรูปแบบไม่ถูกต้อง: โทเค็นมีรูปแบบไม่ถูกต้องและแยกวิเคราะห์ไม่ได้
    ซอร์สโค้ด

  • NotSupported: "เครื่องมือฝัง" ของ Chromium ไม่รองรับช่วงทดลองใช้จากต้นทางที่กำหนดโดยโทเค็น ซึ่งก็คือเบราว์เซอร์ เช่น Chrome หรือ Edge, WebView หรือ User Agent อื่นๆ
    ซอร์สโค้ด

  • สำเร็จ: โทเค็นมีรูปแบบที่ถูกต้อง ยังไม่หมดอายุ ตรงกับฟีเจอร์ช่วงทดลองใช้จากต้นทาง และส่งคำขอจากต้นทางที่คาดไว้
    ซอร์สโค้ด

  • TokenDisabled: โทเค็นมีสถานะเป็นปิดใช้และไม่สามารถใช้ได้
    ซอร์สโค้ด

  • TrialNotAllowed: ช่วงทดลองใช้จากต้นทางไม่พร้อมใช้งานสำหรับผู้ใช้ปัจจุบัน
    ซอร์สโค้ด

  • UnknownTrial: โทเค็นจะระบุชื่อฟีเจอร์ที่ไม่ตรงกับการทดลองใช้ที่รู้จัก
    ซอร์สโค้ด

  • WrongOrigin: ต้นทางของคำขอไม่ตรงกับต้นทางที่ระบุไว้ในโทเค็น ซึ่งอาจรวมถึงรูปแบบ ชื่อโฮสต์ หรือพอร์ต สถานะนี้จะแสดงด้วยหากมีการระบุโทเค็นของบุคคลที่สามในส่วนหัว HTTP, เมตาแท็ก หรือสคริปต์ในหน้า แทนที่จะระบุจากไฟล์ JavaScript ภายนอก
    ซอร์สโค้ด

  • WrongVersion: เวอร์ชันโทเค็นไม่ถูกต้อง: ปัจจุบันรองรับเฉพาะโทเค็นเวอร์ชัน 2 และ 3 เท่านั้น
    ซอร์สโค้ด


ใช้ไม่ได้ 🤔

หากช่วงทดลองใช้จากต้นทางไม่ทำงานตามที่คาดไว้ ให้ตรวจสอบว่าคุณได้ปฏิบัติตามเงื่อนไขต่อไปนี้

คุณกำลังทดสอบใน Chrome ไม่ใช่ Chromium หรือเบราว์เซอร์อื่น

ช่วงทดลองใช้จากต้นทางของ Chrome ออกแบบมาเพื่อใช้สำหรับผู้ใช้ Chrome อย่าอาศัยโทเค็นช่วงทดลองใช้จาก Chrome จากต้นทาง ในการเปิดใช้ฟีเจอร์ช่วงทดลองใช้ในเบราว์เซอร์อื่นๆ รวมถึง Chromium และเบราว์เซอร์อื่นๆ ที่มีพื้นฐานมาจาก Chromium เนื่องจากช่วงทดลองใช้จากต้นทางของ Chrome มีไว้สำหรับการทดสอบฟีเจอร์ที่มีใน Chrome เท่านั้น

ช่วงทดลองใช้จากต้นทางยังพร้อมใช้งานสําหรับ Firefox และ Microsoft Edge ด้วย การลงทะเบียนในช่วงทดลองใช้ Firefox หรือ Edge จากต้นทางจะไม่เปิดใช้ฟีเจอร์ใน Chrome

เปิดใช้ช่วงทดลองใช้จากต้นทางสำหรับเวอร์ชัน Chrome ที่เข้าถึงเว็บไซต์ของคุณ

สิทธิ์เข้าถึงช่วงทดลองใช้จะจำกัดให้ใช้ได้เฉพาะ Chrome บางเวอร์ชันเท่านั้น ในบางกรณี ปัญหานี้อาจหมายความว่าฟีเจอร์ทดลองใช้ จะพร้อมใช้งานสำหรับ Chrome เวอร์ชันก่อนเสถียรเท่านั้น ซึ่งได้แก่ Canary, Dev และ Beta

คุณตรวจสอบความพร้อมใช้งานของเวอร์ชันได้จากหน้าการลงทะเบียนสำหรับช่วงทดลองใช้ ดังนี้

หน้าช่วงทดลองใช้ Chrome จากต้นทาง
สำหรับชุดบุคคลที่หนึ่งและ SameParty ซึ่งไฮไลต์ความพร้อมใช้งานของ Chrome

คุณสามารถตรวจสอบเวอร์ชันของ Chrome ที่ใช้อยู่ได้จาก chrome://version

การตั้งค่า Chrome ไม่ได้ปิดใช้ช่วงทดลองใช้จากต้นทาง

หากผู้ใช้แต่ละรายรายงานว่าฟีเจอร์ใดใช้งานไม่ได้ ให้ตรวจสอบว่าฟีเจอร์ดังกล่าวไม่ได้ปิดอยู่ในการตั้งค่า Chrome ของผู้ใช้ ตัวอย่างเช่น คุณปิดใช้ฟีเจอร์ Privacy Sandbox ได้จากหน้า chrome://settings/privacySandbox

คีย์เวิร์ดและไวยากรณ์ถูกต้อง

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

สำหรับการใช้งานของบุคคลที่หนึ่ง คุณจะระบุโทเค็นในเมตาแท็ก origin-trial ได้ดังนี้

<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

หรือคุณจะระบุโทเค็นในส่วนหัวการตอบกลับ Origin-Trial ก็ได้ นี่คือตัวอย่างการใช้ Express ใน Node.js

app.use(function(req, res, next) {
  res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
  next();
});

นอกจากนี้ คุณยังให้โทเค็นได้โดยใช้ JavaScript ดังนี้

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

ต้นทางโทเค็นของบุคคลที่หนึ่งตรงกับต้นทางของหน้า

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

ตัวอย่างเช่น หากคุณเลือก https://example.com เป็นต้นทางเว็บ

หน้าช่วงทดลองใช้จาก Chrome จากต้นทาง
ซึ่งแสดง https://example.com ที่เลือกเป็นเว็บจากต้นทาง

คุณอาจได้รับค่าโทเค็นดังนี้

หน้าช่วงทดลองใช้จาก Chrome 
แสดงค่าโทเค็น

ตรวจสอบว่าค่านี้ตรงกับโทเค็นที่ใช้ในหน้าเว็บที่คุณกำลังแก้ปัญหา

สำหรับโทเค็นที่ระบุในเมตาแท็ก ให้ตรวจสอบ HTML ดังนี้

  <meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

สําหรับโทเค็นที่ให้ไว้ในส่วนหัว คุณสามารถตรวจสอบค่าโทเค็นจากแผง Chrome DevTools Network ในส่วนส่วนหัวการตอบกลับได้ โดยทำดังนี้

เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome 
แผงเครือข่ายแสดงส่วนหัวการตอบกลับเกี่ยวกับช่วงทดลองใช้จากต้นทาง

โทเค็นของบุคคลที่หนึ่งจะแสดงจากต้นทางที่ใช้โทเค็นดังกล่าว

หากต้องการเปิดใช้การเข้าถึงฟีเจอร์ช่วงทดลองใช้จากต้นทางสำหรับโค้ดที่รวมอยู่ในหน้าที่แสดงจากต้นทางของคุณ ให้ระบุโทเค็นการทดลองใช้ในเมตาแท็ก ส่วนหัว หรือผ่าน JavaScript จากต้นทางเดียวกัน

ต้นทางที่ลงทะเบียนสำหรับโทเค็นต้องตรงกับต้นทางที่แสดงโทเค็น

ต้นทางโทเค็นของบุคคลที่สามตรงกับต้นทางของสคริปต์

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

เช่น หากต้องการให้สคริปต์ที่ให้บริการจาก javascript-library.example เข้าร่วมช่วงทดลองใช้จากต้นทาง คุณต้องลงทะเบียนโทเค็นกับการจับคู่ของบุคคลที่สามสำหรับ javascript-library.example

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

ค่าต้นทางสำหรับโทเค็นของบุคคลที่สามต้องตรงกับต้นทางของสคริปต์ที่แทรกโทเค็นดังกล่าว

สคริปต์ของบุคคลที่สามใช้โทเค็นของบุคคลที่สาม

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

สคริปต์ของบุคคลที่สามต้องใช้โทเค็นที่เปิดใช้การจับคู่บุคคลที่สามอยู่ โดยแทรกผ่านตัวสคริปต์ (ไม่รวมอยู่ในเมตาแท็กหรือส่วนหัวในเว็บไซต์) โดยใช้โค้ดดังตัวอย่างต่อไปนี้

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

โทเค็นของบุคคลที่สามมีให้ผ่านสคริปต์ภายนอก ไม่ใช่เมตาแท็ก ส่วนหัว HTTP หรือสคริปต์ในหน้า

ระบบจะตรวจสอบโทเค็นของบุคคลที่สามเทียบกับต้นทางของสคริปต์ที่แทรกโทเค็น แต่สคริปต์ในหน้าและแท็ก <meta> ในมาร์กอัปแบบคงที่จะไม่มีต้นทาง (นั่นคือ URL แหล่งที่มา)

ซึ่งหมายความว่าคุณต้องระบุโทเค็นของบุคคลที่สามผ่านสคริปต์ภายนอก ไม่ใช่ในแท็ก <meta> หรือสคริปต์ในหน้า ไม่ว่าสคริปต์ภายนอกที่แทรกโทเค็นจะมาจากต้นทางเดียวกับหน้าที่มีหรือมาจากต้นทางอื่น ตราบใดที่ต้นทางของสคริปต์ตรงกับต้นทางที่ลงทะเบียนสำหรับการทดลอง

คุณสามารถดูการสาธิตนี้ได้ที่ ot-iframe-3p.glitch.me

ระบบรองรับสิทธิ์เข้าถึงฟีเจอร์ช่วงทดลองใช้จากต้นทางสำหรับวิธีที่ใช้จัดหาโทเค็นการทดลองใช้

การเข้าถึงฟีเจอร์ช่วงทดลองใช้จากต้นทางบางประเภทกำหนดให้คุณระบุโทเค็นการทดลองใช้ด้วยวิธีการที่เฉพาะเจาะจง ตัวอย่างเช่น วิธีเดียวที่จะเปิดใช้การเข้าถึงช่วงทดลองใช้ต้นทางสำหรับ Service Worker และ Shared Worker ได้ก็คือการระบุโทเค็นในส่วนหัว Origin-Trial

เปิดใช้การจับคู่โดเมนย่อยสำหรับโทเค็นที่ใช้ในโดเมนย่อย

หากฟีเจอร์ช่วงทดลองใช้จากต้นทางใช้ไม่ได้กับบางหน้าในเว็บไซต์ของคุณ ให้ตรวจสอบว่า โทเค็นได้รับการตั้งค่าอย่างถูกต้องสำหรับโดเมนย่อยที่ให้บริการโทเค็นเหล่านั้น

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

หน้าลงทะเบียนช่วงทดลองใช้จากต้นทางของ Chrome 
ซึ่งแสดงการจับคู่โดเมนย่อยที่เลือก

คุณยังสามารถจับคู่โดเมนย่อยสำหรับโทเค็นของบุคคลที่สามได้ด้วย โดยทำดังนี้

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

จะไม่ออกโทเค็นโดเมนย่อยสำหรับต้นทางในรายการคำต่อท้ายสาธารณะ เช่น คุณจะจดทะเบียนต้นทางอย่าง https://appspot.com หรือ https://github.io ไม่ได้ แต่จะจดทะเบียนโดเมนภายในต้นทางนั้นได้ เช่น https://example.appspot.com หรือ https://example.github.io

โทเค็นยังใช้งานได้

โทเค็นมีอายุ 6 สัปดาห์หลังจากที่สร้าง หลังจากนั้น คุณต้องส่งความคิดเห็น เพื่อขยายวันที่มีผลจนถึง คู่มือช่วงทดลองใช้จากต้นทางสำหรับนักพัฒนาเว็บจะอธิบายวิธีตรวจสอบว่าโทเค็นของคุณใช้ได้กับช่วงทดลองใช้จากต้นทางทั้งหมด

คุณตรวจสอบโทเค็นที่ใช้งานอยู่ได้ในหน้าการลงทะเบียนของฉันช่วงทดลองใช้จากต้นทางของ Chrome

ช่วงทดลองใช้จากต้นทางของ Chrome 
หน้าการลงทะเบียนของฉันแสดงสิทธิ์ใช้จนถึงวันที่

Chrome DevTools จะแสดงสถานะ Success หากโทเค็นยังคงใช้งานได้

ข้อมูลการทดลองใช้ต้นทางของ Chrome DevTools ในแผงแอปพลิเคชัน โดยไฮไลต์สถานะ: Success

หากโทเค็นหมดอายุ เครื่องมือสำหรับนักพัฒนาเว็บจะแสดงสถานะ Expired และหน้าการลงทะเบียนของฉันจะแสดงส่วนโทเค็นที่หมดอายุ

ช่วงทดลองใช้จากต้นทางของ Chrome 
หน้าการลงทะเบียนของฉันแสดงโทเค็นที่หมดอายุ

ช่วงทดลองใช้จากต้นทางยังไม่สิ้นสุด

คุณตรวจสอบวันที่สิ้นสุดของช่วงทดลองใช้จากต้นทางได้จากหน้าการลงทะเบียน ดังนี้

หน้าช่วงทดลองใช้จาก Chrome จากต้นทางสำหรับชุดบุคคลที่หนึ่งและ SameParty ซึ่งไฮไลต์รายละเอียดของช่วงทดลองใช้จากต้นทาง

สำหรับช่วงทดลองใช้ที่สิ้นสุดลงแล้ว เครื่องมือสำหรับนักพัฒนาเว็บจะแสดงข้อมูลดังนี้

ข้อมูลการทดลองใช้ต้นทางใน Chrome DevTools ในแผงแอปพลิเคชันที่แสดง ValidTokenNotProvided และ Status Expiration

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

ช่วงทดลองใช้จากต้นทางพร้อมให้บริการสำหรับผู้ใช้ปัจจุบัน

ช่วงทดลองใช้จากต้นทางบางรายการไม่พร้อมใช้งานสําหรับผู้ใช้บางราย แม้ว่าจะมีการระบุโทเค็นที่ถูกต้องก็ตาม

หากการทดลองใช้ไม่พร้อมใช้งานสำหรับผู้ใช้ปัจจุบัน เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome จะแสดงคำเตือน TrialNotAllowed ดังนี้

ข้อมูลการทดลองใช้จากต้นทางของ Chrome DevTools ในแผงแอปพลิเคชันที่แสดงคำเตือน TrialNotAllowed

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

คุณควรใช้การตรวจหาฟีเจอร์เพื่อยืนยันว่าระบบรองรับฟีเจอร์ช่วงทดลองใช้จากต้นทางก่อนที่จะใช้งาน เช่นเดียวกับฟีเจอร์แพลตฟอร์มเว็บอื่นๆ

ยังไม่เกินขีดจำกัดการใช้งานช่วงทดลองใช้จากต้นทาง

โดยค่าเริ่มต้น ระบบจะเปิดใช้ฟีเจอร์ช่วงทดลองใช้จากต้นทางในหน้าใดก็ได้ที่มีโทเค็นที่ถูกต้องสำหรับช่วงทดลองใช้

อย่างไรก็ตาม การใช้งานช่วงทดลองใช้จากต้นทางจะจำกัดไว้ที่ 0.5% ของการโหลดหน้าเว็บ Chrome ทั้งหมด ยกเว้นกรณีที่พบไม่บ่อยนัก ระบบจะปิดใช้ฟีเจอร์ช่วงทดลองใช้จากต้นทางหากผู้ใช้ Chrome ทั้งหมดใช้งานรวมเกินขีดจำกัดดังกล่าว เครื่องมือสำหรับนักพัฒนาเว็บจะแสดงสถานะโทเค็นเป็นปิดใช้

ไม่มีขีดจำกัดการใช้งานสำหรับช่วงทดลองเลิกใช้งาน เนื่องจากฟีเจอร์เหล่านี้ไม่ได้เปิดตัวฟีเจอร์ใหม่ๆ และไม่ก่อให้เกิดความเสี่ยงต่อการทำให้เนื้อหาส่วนใหญ่ของเว็บขึ้นอยู่กับฟีเจอร์ทดลอง

บางช่วงทดลองใช้ให้ตัวเลือกในการจำกัดการใช้งานด้วย ซึ่งหมายความว่าระบบจะปิดใช้ฟีเจอร์ช่วงทดลองใช้จากต้นทางสำหรับผู้ใช้บางราย ตัวเลือกนี้พร้อมให้ใช้งานจากหน้าการลงทะเบียนสำหรับช่วงทดลองใช้จากต้นทางที่ให้บริการต่อไปนี้

หน้าการลงทะเบียนทดลองใช้จากต้นทาง
Chrome แสดงข้อจำกัดการใช้งาน

หากคุณสังเกตเห็นว่าผู้ใช้เข้าถึงฟีเจอร์ช่วงทดลองใช้จากต้นทางได้ต่ำกว่าที่คาดไว้ โปรดตรวจสอบว่าได้เลือก "ขีดจำกัดมาตรฐาน" แล้ว

Iframes ให้โทเค็นของตนเอง

iframe ต้องระบุโทเค็นในเมตาแท็ก, ส่วนหัว HTTP หรือแบบเป็นโปรแกรม จึงจะอนุญาตการเข้าถึงฟีเจอร์ช่วงทดลองใช้จากต้นทางได้ iframe จะไม่ได้รับสิทธิ์เข้าถึงฟีเจอร์ที่เปิดใช้สำหรับหน้าเว็บที่มีแท็กดังกล่าว

ot-iframe.glitch.me แสดงการเข้าถึงฟีเจอร์ทดลองใช้จากต้นทางจาก iframe ot-iframe-3p.glitch.me มีตัวอย่าง iframe แบบข้ามต้นทางหลายรายการ

นโยบายสิทธิ์ได้รับการกำหนดค่าอย่างถูกต้อง

ฟีเจอร์ช่วงทดลองใช้จากต้นทางบางรายการอาจได้รับผลกระทบจากส่วนหัว Permissions-Policy (ก่อนหน้านี้เรียกว่าส่วนหัว Feature-Policy) คุณสามารถตรวจสอบได้ใน ความตั้งใจที่จะทดสอบ สำหรับฟีเจอร์ช่วงทดลองใช้ หรือในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์สำหรับฟีเจอร์ดังกล่าวใน web.dev หรือ developer.chrome.com/blog

ตรวจสอบว่าฟีเจอร์ที่คุณพยายามเข้าถึงไม่ได้ถูกบล็อกโดยคำสั่งของ Permissions-Policy คุณสามารถตรวจสอบส่วนหัวการตอบกลับในแผงเครือข่ายเครื่องมือสำหรับนักพัฒนาเว็บใน Chrome และดูรายการฟีเจอร์ทั้งหมดที่อนุญาตได้ในแผงแอปพลิเคชัน

แผงแอปพลิเคชัน Chrome DevTools 
  แสดงฟีเจอร์ที่อนุญาตของนโยบายสิทธิ์

แล้วผู้ปฏิบัติงานล่ะ

ฟีเจอร์ช่วงทดลองใช้จากต้นทางสามารถพร้อมใช้งานสำหรับโปรแกรมทำงานของบริการ ผู้ปฏิบัติงานที่แชร์ และผู้ปฏิบัติงานที่ได้รับมอบหมาย อย่างไรก็ตาม วิธีเดียวที่จะทำให้ Service Worker และ User Worker เข้าถึงได้คือการให้โทเค็นในส่วนหัว Origin-Trial

ผู้ปฏิบัติงานที่ได้รับมอบหมายจะมีสิทธิ์เข้าถึงฟีเจอร์ที่เปิดใช้โดยเอกสารระดับบนสุด

ให้โทเค็นก่อนเข้าถึงฟีเจอร์

ตรวจสอบว่าได้ให้โทเค็นช่วงทดลองใช้จากต้นทางก่อนที่จะเข้าถึงฟีเจอร์ช่วงทดลองใช้ เช่น หากหน้าเว็บให้โทเค็นผ่าน JavaScript ให้ตรวจสอบว่าโค้ดที่ใช้ระบุโทเค็นทำงานก่อนโค้ดที่พยายามเข้าถึงฟีเจอร์ทดลอง

การสาธิตช่วงทดลองใช้จากต้นทาง

ดูข้อมูลเพิ่มเติม