开始试用源试用

测试新的 Web 平台功能或实验性功能。

Sam Dutton

您可以通过源试用来使用新功能或实验性功能，以便构建功能，供用户在该功能面向所有人发布之前限时试用。

当 Chrome 提供某项功能的源试用时，您可以注册试用，从而为源站上的所有用户启用该功能，而无需切换任何标志或切换到 Chrome 的备用 build（尽管他们可能需要升级）。借助源试用，开发者可以使用新功能构建演示版和原型。这些试用还有助于 Chrome 工程师了解新功能的使用情况，以及这些功能如何与其他网络技术交互。

Origin 试用版面向所有开发者开放。它们的有效期和使用次数有限。参与该计划的过程由您自行管理，并且提供的文档和支持有限。学员应愿意并能够使用可用文档（目前可能仅限 API 规范和说明文档）相对独立地开展工作，不过我们会尽可能提供指导。

如果您注册了试用，Chrome 团队将定期请您针对试用功能的使用情况提供具体反馈。某些功能可能会经历多次来源测试，以便纳入反馈并进行调整。

起源试验也适用于 Firefox 和 Microsoft Edge。

第三方源试用

来源试用通常仅适用于第一方来源：仅适用于单个已注册的来源。借助第三方来源试用，嵌入式内容提供商可以在多个网站上试用新功能，而无需为每个来源都获取令牌。

如需了解详情，请参阅什么是第三方源试用？

弃用试用

并非所有源试用都用于测试新 API。某些试用版会暂时重新启用已弃用的功能。这些测试称为弃用试用，在某些情况下也称为“反向”源试用。

例如，从 Chrome 85 开始，AppCache 在 Chrome 中默认不再可用。需要更多时间才能从 AppCache 迁出的网站可以报名参加弃用试用计划，以便继续使用 AppCache，直到 Chrome 93 为止。

参与源试用

  1. 从有效试用列表中选择一项源试用。
  2. 点击注册按钮并填写表单，申请令牌。
  3. 在您希望启用试用功能的每个网页上提供令牌：
    • 作为 <head> 中的元标记：<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • 作为 HTTP 标头：Origin-Trial: TOKEN_GOES_HERE
    • 以编程方式提供令牌。
  4. 试用新功能。
  5. 提交反馈。您可以通过初始试用网站执行此操作。此类反馈不是公开的，只有 Chrome 团队中的部分人员提供。每个试用版都为自发的社区反馈提供了一个链接。这通常指向 GitHub 或某个其他公共渠道上的功能。
  6. 令牌过期后，您会收到一封包含续订链接的电子邮件。为此，系统会再次要求您提交反馈。

您可以针对不同的来源多次注册同一源试用，并在同一网页中添加多个令牌。如果您需要提供对来自不同来源的资源（例如您拥有的多个网站上包含的代码）有效的令牌，这会非常有用。

源试用框架会查找第一个有效令牌，然后忽略所有其他令牌。您可以使用 Chrome 开发者工具验证这一点。

以编程方式提供令牌

如前所述，您无需将令牌作为 HTTP 标头或元标记形式在网页 HTML 中提供，而是可以使用 JavaScript 注入令牌：

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。

令牌和扩展

如需在后台脚本、弹出式窗口、侧边栏或屏幕外文档中使用试用功能，请在 manifest.json 文件中使用 trial_tokens 键。

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

内容脚本的处理方式有所不同。向一个世界公开地图项可能会令人困惑且不够直观。使用 declarativeNetRequest 插入标头或直接在内容脚本中以编程方式将令牌添加到页面，而不是使用清单的 trial_token。请注意，令牌与特定网域相关联，因此您应该为运行内容脚本的网域注册一个令牌，而不是为扩展程序 ID 注册一个。

如需为扩展程序注册试用，请使用网址 chrome-extension://YOUR_EXTENSION_ID，例如 chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk。

续订源试用计划的注册

如果源试用延长，您将收到一封电子邮件，警告您需要续订注册并为试用注册的每个源提供新令牌。

  1. 前往我的注册页面。

  2. 对于已注册延长试用期的每个来源，请点击续订按钮。Chrome 源试用的“我的注册”页面的屏幕截图，其中显示了“续订”按钮

  3. 复制新令牌，并将其提供给应继续参与试用计划的每个网页。如有必要，您可以提供多个令牌：Chrome 会忽略无效或已过期的令牌。

查看源试用信息

在 Chrome 开发者工具的 Application 面板中，查看网页可用的源试用的相关信息。

Chrome DevTools **Application** 面板的 Frame 详情视图中显示的网站的源试用信息。

您还可以使用我们的源试用令牌解码器查看在令牌中编码的数据。

来源试用解码器工具，显示已解码的来源试用值。

源试用演示

了解详情