開始使用來源試用

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

Sam Dutton
Sam Dutton

來源試用可讓您存取全新或實驗功能，以便建構功能，讓使用者在限定期間內試用該功能之前。

當 Chrome 為某項功能提供來源試用版時，您可以註冊試用版，為來源的所有使用者啟用這項功能，而無須要求他們切換任何標記或切換至其他 Chrome 版本 (但可能需要升級)。開發人員可透過來源試用功能，使用新功能建構示範和原型。此外，這項測試也能幫助 Chrome 工程師瞭解新功能的使用情形，以及這些功能與其他網路技術的互動方式。

Origin 試用版向所有開發人員開放。但使用時間和次數有限。參與者必須自行管理，且僅提供有限的文件和支援服務。參與者應願意並能根據可用的說明文件彼此獨立工作，在這個階段中，可能僅限於 API 規格和說明，不過我們會盡量提供指引。

如果你註冊了試用版，Chrome 團隊會定期詢問你對試用功能的具體使用意見回饋。部分功能可能會經歷多次測試，因為我們會納入使用者意見並進行調整。

Firefox 和 Microsoft Edge 也包括來源試用。

第三方來源測試

來源試用版通常只適用於第一方：只適用於單一已註冊的來源。透過第三方來源試用，嵌入內容的提供者可以在多個網站上試用新功能，而無須為每個來源取得權杖。

進一步瞭解：什麼是第三方來源測試？

淘汰試用計畫

並非所有來源試用版都用於測試新的 API。部分測試可讓已淘汰的功能暫時重新啟用。這類測試稱為淘汰測試，在某些情況下也稱為「反向」來源測試。

舉例來說，Chrome 預設不再提供 Chrome 85 版的 AppCache。如果網站需要額外時間才能從 AppCache 遷移，可以註冊淘汰試用計畫，這樣就能在 Chrome 93 版推出前繼續使用 AppCache。

參加來源試用

  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 插入權杖，而無須提供權杖做為 HTTP 標頭或網頁 HTML 中的中繼標記：

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

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

符記和 iFrame

如要透過 iframe 存取試用功能，您可以在 Meta 標記、HTTP 標頭或程式設計中提供試用權杖。

對於所有符記使用情形，為符記註冊的來源必須與存取試用功能的 JavaScript 內容相符：包含內嵌指令碼的網頁來源，或是從外部檔案加入的 JavaScript 的 <script> 元素 src。

符記和擴充功能

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

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

內容指令碼的處理方式不同。向單一全世界公開地圖項目可能會造成混淆及違反直覺。請不要使用資訊清單的 trial_token，而是直接在內容指令碼中使用 宣告式 NetRequest 或以程式設計方式插入標頭，將符記新增至網頁。請注意，權杖會與特定網域綁定，因此您應為內容指令碼執行的網域註冊一個權杖，而非���充功能 ID。

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

續訂來源試用註冊

如果來源試用已延長，您會收到電子郵件警告，指出您必須更新註冊約期，並為試用期間註冊的每個來源提供新權杖。

  1. 前往「我的註冊」頁面。

  2. 針對每個註冊延長試用期的來源，按一下「RENEW」按鈕。 Chrome 原始試用版「我的註冊」頁面螢幕截圖，顯示「RENEW」按鈕

  3. 複製新權杖，並將其提供給應繼續註冊試用的每個頁面。如有需要，您可以提供多個符記：Chrome 會忽略無效或過期的權杖。

查看來源試用資訊

前往 Chrome 開發人員工具的「Application」面板，查看頁面提供的來源試用資訊。

在 Chrome 開發人員工具的「應用程式」面板中顯示的網站來源試用資訊，以框架詳細資料檢視畫面顯示。

您也可以使用原點試用版權杖解碼器查看權杖中編碼的資料。

來源試用解碼器工具，顯示已解碼的來源試用值。

來源試用示範

瞭解詳情