开始试用源试用

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

Sam Dutton

您可以通过源试用来使用新功能或实验性功能，以便在限时内测试此功能并将其提供给用户。在完成试用并评估反馈后，Chrome 会决定是否应向所有用户提供该功能。

您可以注册参与源代码试用，为源代码中的所有用户启用某项功能，而无需他们切换任何标志或改用其他 Chrome 版本（不过，他们可能需要升级）。注册后，开发者就可以使用新功能构建演示版和原型。这些试用还可帮助 Chrome 工程师了解新功能的使用方式以及它们可能与其他 Web 技术的互动方式。

可用性

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

如果您注册试用，Chrome 团队会定期向您征求有关试用功能使用体验的具体反馈。某些功能可能会经历多次来源测试，以便纳入反馈并进行调整。

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

第三方来源试用

默认情况下，源试用功能仅适用于为试用注册的来源。部分试用版在注册时提供第三方匹配选项。这样，嵌入式内容或服务的提供商就可以在多个网站上试用新功能，而无需为每个来源提供令牌。

了解详情：什么是第三方来源试用？

弃用试用

在某些源试用中，您可以暂时重新启用已废弃的功能。 这类测试称为弃用试用。在某些上下文中，这些试用称为“反向”源试用。

例如，从 Chrome 127 开始，移除了更改事件。如果网站需要额外的时间来移除这些事件，可以注册弃用试用计划，以便在指定网站上暂时重新启用这些事件。

参与源试用

  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 开发者工具验证这一点。

以编程方式提供令牌

您可以使用 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。

令牌和扩展程序

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

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

内容脚本的处理方式有所不同。向一个世界公开某项功能可能会令人困惑且不直观。请改用以下任一方法将令牌添加到网页，而不是使用清单的 trial_token：

请注意，令牌会与特定网域相关联，因此您需要注册内容脚本所运行的网域，而不是您的扩展程序 ID。

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

续订源试用计划的注册

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

  1. 前往我的注册。
  2. 对于已注册延长试用期的每个来源，请点击续订。显示“续订”按钮的“我的注册”页面示例
  3. 复制新令牌，并将其提供给应继续参与试用计划的每个网页。如果需要，您可以提供多个令牌。

Chrome 会忽略无效或过期的令牌。

查看来源试用信息

在 Chrome 开发者工具的应用面板中，查看可供网站使用的源试用计划的相关信息。

Chrome DevTools 应用面板中的帧详情视图。

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

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

演示

以下网站展示了令牌部署示例。

如何提供来源试用令牌

源试用工具

源试用中的功能

以下是正在进行的源试用中的 API 演示

资源

继续阅读我们的 Chrome 概念文档：

详细了解 Chrome 中的源试用：

其他浏览器

在其他浏览器中查找来源试用：