测试新的或实验性的网络平台功能。
通过源试用,您可以使用新功能或实验性功能,以构建可供用户在有限时间内试用的功能,该功能可供所有用户使用。
当 Chrome 针对某项功能提供源试用时,您可以注册该试用,从而为源站中的所有用户启用此功能,而无需他们切换任何标志或切换到 Chrome 的备用 build(尽管他们可能需要升级)。借助源试用,开发者可以使用新功能构建演示版和原型。这些试用项目还有助于 Chrome 工程师了解新功能的使用方式,以及这些功能可能会如何与其他网络技术交互。
源试用是公开的,面向所有开发者开放。它们的时长和用量有限。测试是一个自行管理的流程,提供的文档和支持有限。参与者应愿意并且能够使用所提供的文档相对独立地开展工作,在此阶段,这些文档很可能仅限于 API 规范和解释器,但我们会尽可能提供相关指导。
如果您注册试用,Chrome 团队将会定期请您提供有关试用功能的具体反馈。某些功能可能会经历多次源试用,因为我们会整合反馈并做出调整。
我们还针对 Firefox 和 Microsoft Edge 提供源试用。
第三方源试用
源试用通常只能在第一方基础上进行:它们仅适用于单个已注册的源站。通过第三方源试用,嵌入式内容的提供商可以跨多个网站试用新功能,而无需为每个源站使用令牌。
如需了解详情,请参阅什么是第三方源试用?
弃用试用
并非所有源试用都用于测试新 API。某些试用版功能可以暂时重新启用已弃用的功能。这些试验称为“弃用试验”,在某些情况下称为“反向”源试用。
例如,从 Chrome 85 开始,默认情况下 Chrome 中已不再提供 AppCache。需要额外时间从 AppCache 迁移的网站可以注册加入弃用试用,以便继续使用 AppCache,直至 Chrome 93。
参与源试用
- 从有效试用列表中选择一个源试用。
- 点击注册按钮并填写表单,以请求令牌。
- 在您希望启用试用功能的每个网页上提供令牌:
- 作为 <head> 中的元标记:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- 作为 HTTP 标头:
Origin-Trial: TOKEN_GOES_HERE
- 以编程方式提供令牌。
- 作为 <head> 中的元标记:
- 试用新功能。
- 提交反馈。请通过源试用网站执行此操作。此反馈不会公开,仅供 Chrome 团队中的有限部分人员使用。每次试用版都会提供一个链接,让用户自发地社区反馈。 这通常指向 GitHub 上的该功能或某个其他公共渠道。
- 当您的令牌过期后,您会收到一封包含续订链接的电子邮件。为此,系统会再次要求您提交反馈。
您可以针对不同源多次注册同一源试用,并在同一页面中包含多个令牌。如果您需要提供对不同来源提供的资源(例如您拥有的多个网站上包含的代码)有效的令牌,这会非常有用。
源试用框架会查找第一个有效令牌,然后忽略所有其他令牌。您可以使用 Chrome DevTools 进行验证。
以编程方式提供令牌
您可以使用 JavaScript 注入令牌,而不是如前所述在网页的 HTML 中以 HTTP 标头或元标记的形式提供令牌:
const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);
如果您正在参与第三方试用,请使用此方法。
令牌和 iframe
如需通过 iframe 访问试用功能,您可以在元标记或 HTTP 标头中提供试用令牌,也可以以编程方式提供。
对于所有令牌使用行为,为令牌注册的来源必须与用于试用功能的 JavaScript 上下文匹配:页面的来源包含内嵌脚本,或者与外部文件中包含 JavaScript 的 <script>
元素的 src
匹配。
令牌和扩展
如需在后台脚本、弹出式窗口或屏幕外文档中使用试用功能,请将 trial_token 添加到您的 manifest.json 文件中。
内容脚本的处理方式不同。将一个地图项公开到一个“世界”可能会令人困惑且不直观。通过使用 declarativeNetRequest 插入标头或直接在内容脚本中以编程方式将令牌添加到页面,而不要使用清单的 trial_token
。请注意,令牌与特定网域相关联,因此您需要为运行内容脚本的网域注册一个令牌,而不是为您的扩展程序 ID 进行注册。
如需注册您的扩展程序以进行试用,请使用网址 chrome-extension://YOUR_EXTENSION_ID
,例如 chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk
。
续订源试用注册
如果源试用的期限延长,您会收到一封电子邮件警告,要求您续订注册,并为参加试用的每个源提供新令牌。
前往 My Registrations(我的注册)页面。
对于每个已注册延长试用期的源站,点击续订按钮。
复制新令牌,并将其用于应该继续参与试用的每个页面。您可以在必要时提供多个令牌:Chrome 会忽略无效或已过期的令牌。
查看源试用信息
在 Chrome DevTools 的 Application(应用)面板中查看相应页面可用的源试用的相关信息。
您还可以使用我们的源试用令牌解码器来查看在令牌中编码的数据。