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

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

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

หากพบข้อบกพร่องเกี่ยวกับช่วงทดลองใช้จากต้นทางใน Chrome ให้ส่งปัญหาใหม่ในที่เก็บ GitHub ของช่วงทดลองใช้จากต้นทางของ Chrome

เช็กลิสต์

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




















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

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

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

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

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

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

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

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

รหัสสถานะ

คุณอาจเห็นรหัสสถานะต่อไปนี้ในเครื่องมือสำหรับนักพัฒนาเว็บของ 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 และเบต้า

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

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

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

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

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

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

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

สําหรับการใช้งานของบุคคลที่หนึ่ง คุณสามารถระบุโทเค็นในเมตาแท็ก 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 Origin ที่แสดงค่าโทเค็น

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// Add a third-party OT token
function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

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

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

ซึ่งหมายความว่าต้องระบุโทเค็นของบุคคลที่สามด้วยสคริปต์ภายนอก ไม่ใช่ในแท็ก <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 Origin Trials ได้หน้าการลงทะเบียนของฉัน โดยทำดังนี้

การทดลองใช้แหล่งที่มาของ Chrome 
หน้าการลงทะเบียนของฉันที่แสดงวันที่ &quot;ใช้งานได้จนถึง&quot;

Chrome DevTools จะแสดงสถานะ Success หากโทเค็นยังมีผลอยู่

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

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

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

ช่วงทดลองใช้จากต้นทางยังดำเนินอยู่

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

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

สําหรับช่วงทดลองใช้ที่สิ้นสุดแล้ว DevTools จะแสดงข้อมูลประมาณนี้

เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome 
ข้อมูลการทดลองใช้ต้นทางในแผงแอปพลิเคชันแสดง ValidTokenNotProvided และ Status Expired

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Iframe มีโทเค็นของตัวเอง

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

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

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

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

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

แผงแอปพลิเคชันของเครื่องมือสำหรับนักพัฒนาเว็บใน Chrome ซึ่งแสดงฟีเจอร์ที่นโยบายสิทธิ์อนุญาต

แล้วคนงานล่ะ

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

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

มีการระบุโทเค็นก่อนเข้าถึงฟีเจอร์

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

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

เว็บไซต์ต่อไปนี้แสดงตัวอย่างการใช้งานโทเค็น

วิธีระบุโทเค็นช่วงทดลองใช้จากต้นทาง

เครื่องมือช่วงทดลองใช้จากต้นทาง

ฟีเจอร์ในช่วงทดลองใช้จากต้นทาง

ต่อไปนี้เป็นการสาธิต API ในช่วงทดลองใช้จากต้นทางที่ดำเนินอยู่

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