开始试用源试用

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

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

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

可用性

源试用是公开的,面向所有开发者开放。这些优惠有期限和使用限制。参与是一个自行管理的过程,文档和支持有限。参与者应愿意且能够使用现有文档相对独立地开展工作,在现阶段,这些文档可能仅限于 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。

令牌和扩展程序

如需在后台脚本、弹出式窗口、侧边栏或屏幕外文档中使用试用功能,请在 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 开发者工具“Application”面板框架详细信息视图。

源试用中的功能

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

资源

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

详细了解 Chrome 中的源试用:

其他浏览器

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