開始使用來源試用

測試新的或實驗性網路平台功能。

Sam Dutton

您可以透過來源試用程序，在限定時間內使用新功能或實驗功能，以便測試並提供給使用者。試用期結束並評估意見回饋後，Chrome 會決定是否要向所有人開放這項功能。

您可以註冊來源試用，為來源上的所有使用者啟用功能，而不必切換任何旗標或改用其他 Chrome 版本 (但可能需要升級)。註冊後，開發人員就能使用新功能建構示範和原型。此外，Chrome 工程師也能透過試用瞭解新功能的使用方式，以及新功能與其他網路技術的互動情形。

可用性

來源試用為公開性質，所有開發人員都能參加。有時間和使用限制。參與過程需自行管理，且文件和支援有限。參與者應願意且能夠使用現有文件相對獨立地工作，現階段可能僅限於 API 規格和說明。我們也會盡可能提供指引。

如果您註冊試用，Chrome 團隊會定期詢問您對試用功能的具體意見。部分功能可能會經過多次來源試用，以便整合意見回饋並進行調整。

Firefox 和 Microsoft Edge 也提供來源試用。

第三方來源試用

根據預設，來源試用功能僅適用於註冊試用的來源。部分試用版在註冊時會提供第三方比對選項。這樣一來，嵌入內容或服務的供應商就能在多個網站上試用新功能，不必為每個來源取得權杖。

詳情請參閱「什麼是第三方來源試用？」一文。

淘汰試用計畫

部分來源試用可讓您暫時重新啟用已淘汰的功能。 這類測試稱為「淘汰試用計畫」。在某些情況下，這類試用稱為「反向」來源試用。

舉例來說，Chrome 127 起移除變化事件。如果網站需要額外時間才能移除這些事件，可以註冊淘汰試用計畫，在指定網站上暫時重新啟用事件。

參與來源試用

1. 從進行中的試用清單選擇來源試用。
2. 按一下「Register」按鈕並填寫表單，即可要求權杖。
3. 在要啟用試用功能的每個網頁上提供權杖：
   • 在 <head> 中加入中繼標記：<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
   • HTTP 標頭：Origin-Trial: TOKEN_GOES_HERE
   • 透過程式提供權杖。
4. 試用新功能。
5. 提交意見回饋。請前往來源試用網站進行這項操作。這項意見回饋不會公開，只有 Chrome 團隊的少數成員可以查看。每項試用也提供連結，方便使用者主動提供社群意見回饋。 這通常會指向 GitHub 或其他公開管道上的功能。
6. 權杖到期時，你會收到內含續約連結的電子郵件。為此，系統會再次要求您提交意見回饋。

您可以多次註冊相同的來源試用，但來源不同，並在同一個頁面中加入多個權杖。如果您需要為不同來源提供的資源提供有效權杖，例如您擁有的多個網站上包含的程式碼，這項功能就非常實用。

來源試用架構會尋找第一個有效權杖，然後忽略所有其他權杖。您可以使用 Chrome 開發人員工具驗證這項資訊。

透過程式提供權杖

您可以使用 JavaScript 插入權杖，而不必像先前所述，在網頁 HTML 中以 HTTP 標頭或中繼標記的形式提供權杖：

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

如果您參與第三方試用，請使用這個方法。

注意：第三方權杖必須在包含 <script> 元素的外部 JavaScript 檔案中提供。第三方權杖無法在中繼標記、內嵌指令碼或 HTTP 標頭中運作。

權杖和 iframe

如要從 iframe 存取試用功能，您可以在中繼標記、HTTP 標頭或透過程式輔助方式提供試用權杖。

與所有權杖用量一樣，為權杖註冊的來源必須與存取試用功能的 JavaScript 內容相符：包含內嵌指令碼的網頁來源，或從外部檔案加入 JavaScript 的 <script> 元素的 src。

權杖和擴充功能

如要在背景指令碼、彈出式視窗、側邊面板或螢幕外文件中使用試用功能，請在 manifest.json 檔案中使用 trial_tokens 鍵。

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

內容指令碼的處理方式不同。如果只向一個世界公開功能，可能會令人困惑且不直覺。請改用trial_token下列其中一種方式，將權杖 新增至頁面：

• 使用 declarativeNetRequest 插入標頭
• 以程式輔助方式直接在內容指令碼中新增。

請注意，權杖會與特定網域連結，因此您必須註冊內容指令碼執行的網域，而非擴充功能 ID。

如要註冊擴充功能試用，請使用網址 chrome-extension://YOUR_EXTENSION_ID，例如 chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk。

更新來源試用註冊

如果來源試用延長，您會收到電子郵件警告，提醒您需要更新註冊資訊，並為參與試用的每個來源提供新的權杖。

1. 前往「我的註冊」。
2. 針對已註冊延長試用期的每個來源，按一下「RENEW」(續約)。
3. 複製新的權杖，並提供給應繼續註冊試用版的每個網頁。如有需要，可以提供多個權杖。

Chrome 會忽略無效或過期的權杖。

注意：2022 年 4 月已移除中斷期間規定。

查看來源試用資訊

在 Chrome 開發人員工具的「Application」面板中，查看網站可用的來源試用資訊。

來源試用中的功能

以下是目前來源試用中 API 的示範

• Translator 和 Language Detector API Playground
• Summarizer API Playground

資源

繼續閱讀 Chrome 概念說明文件：

• 排解 Chrome 來源試用問題
• 什麼是第三方來源試用？

進一步瞭解 Chrome 的來源試用：

• 網頁程式開發人員指南
• 來源試用說明
• 執行來源試用
• 在 Chromium 中推出新功能的程序
• Intent to explain: Demystifying the Blink shipping process
• 在 Chrome 94 的開發人員工具中查看來源試用資訊

其他瀏覽器

在其他瀏覽器中尋找來源試用：

• 在 Microsoft Edge 中使用來源試用
• Firefox 的來源試用