开始试用源试用

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

Sam Dutton

通过源试用，您可以使用新功能或实验性功能，以构建可供用户在限定时间内试用的功能，然后再面向所有用户推出。

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

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

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

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

第三方源试用

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

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

弃用试用

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

例如，从 Chrome 85 开始，AppCache 在 Chrome 中默认不再可用。需要额外时间才能从 AppCache 迁移的网站可以注册弃用试用，以便在 Chrome 93 之前继续使用 AppCache。

参与源试用

  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。

令牌和扩展程序

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

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

内容脚本的处理方式有所不同。向一个世界公开某项功能可能会造成混淆，不利于直观理解。请改用以下方法将令牌添加到网页中，而不是使用清单的 trial_token：使用 declarativeNetRequest 插入标头，或直接在内容脚本中以编程方式插入标头。请注意，令牌会与特定网域相关联，因此您需要为内容脚本运行的网域注册令牌，而不是为您的扩展程序 ID 注册令牌。

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

续订源试用计划的注册

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

  1. 前往 My Registrations（我的注册）页面。

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

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

查看来源试用信息

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

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

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

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

源试用演示

了解详情