測試新的或實驗性的網站平台功能。
來源試用可讓您存取全新或實驗功能,以便建構功能,讓使用者在限定期間內試用該功能之前。
當 Chrome 為某項功能提供來源試用版時,您可以註冊試用版,為來源的所有使用者啟用這項功能,而無須要求他們切換任何標記或切換至其他 Chrome 版本 (但可能需要升級)。開發人員可透過來源試用功能,使用新功能建構示範和原型。此外,這項測試也能幫助 Chrome 工程師瞭解新功能的使用情形,以及這些功能與其他網路技術的互動方式。
Origin 試用版向所有開發人員開放。但使用時間和次數有限。參與者必須自行管理,且僅提供有限的文件和支援服務。參與者應願意並能根據可用的說明文件彼此獨立工作,在這個階段中,可能僅限於 API 規格和說明,不過我們會盡量提供指引。
如果你註冊了試用版,Chrome 團隊會定期詢問你對試用功能的具體使用意見回饋。部分功能可能會經歷多次測試,因為我們會納入使用者意見並進行調整。
Firefox 和 Microsoft Edge 也包括來源試用。
第三方來源測試
來源試用版通常只適用於第一方:只適用於單一已註冊的來源。透過第三方來源試用,嵌入內容的提供者可以在多個網站上試用新功能,而無須為每個來源取得權杖。
進一步瞭解:什麼是第三方來源測試?
淘汰試用計畫
並非所有來源試用版都用於測試新的 API。部分測試可讓已淘汰的功能暫時重新啟用。這類測試稱為淘汰測試,在某些情況下也稱為「反向」來源測試。
舉例來說,Chrome 預設不再提供 Chrome 85 版的 AppCache。如果網站需要額外時間才能從 AppCache 遷移,可以註冊淘汰試用計畫,這樣就能在 Chrome 93 版推出前繼續使用 AppCache。
參加來源試用
- 從有效測試名單中選擇來源測試。
- 如要索取權杖,請按一下「Register」按鈕並填寫表單。
- 在您要啟用試用功能的每個網頁上提供權杖:
- 做為 <head> 中的中繼標記:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- 做為 HTTP 標頭:
Origin-Trial: TOKEN_GOES_HERE
- 透過程式輔助方式提供權杖。
- 做為 <head> 中的中繼標記:
- 試用新功能。
- 提供意見。請透過原始試用網站進行這項操作。這項意見並未公開,只有 Chrome 團隊的部分成員可查看。每個測試版也提供連結,方便使用者隨時提供社群意見回饋。這通常會指向 GitHub 或其他公開管道的功能。
- 權杖到期後,系統會透過電子郵件將續訂連結傳送給您。為此,系統會再次要求您提供意見回饋。
您可以為相同來源的試用方案註冊多次,也可以為不同的來源註冊,並在同一個網頁中加入多個符記。如果您需要針對不同來源提供的資源 (例如在您擁有的多個網站中加入的程式碼) 提供有效的權杖,這項功能就非常實用。
來源測試架構會尋找第一個有效的權杖,然後忽略所有其他權杖。您可以使用 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
。
續訂來源試用註冊
如果來源試用已延長,您會收到電子郵件警告,指出您必須更新註冊約期,並為試用期間註冊的每個來源提供新權杖。
針對每個註冊延長試用期的來源,按一下「RENEW」按鈕。
複製新權杖,並將其提供給應繼續註冊試用的每個頁面。如有需要,您可以提供多個符記:Chrome 會忽略無效或過期的權杖。
查看來源試用資訊
前往 Chrome 開發人員工具的「Application」面板,查看頁面提供的來源試用資訊。
您也可以使用原點試用版權杖解碼器查看權杖中編碼的資料。