开始试用源试用

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

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

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

可用性

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

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

起源试验也适用于 FirefoxMicrosoft 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

令牌和扩展程序

如需在后台脚本弹出式窗口侧边栏屏幕外文档中使用试用功能,请在 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 中的源试用:

其他浏览器

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