开始试用源试用

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

Sam Dutton
Sam Dutton

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

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

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

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

起源试验也适用于 FirefoxMicrosoft 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 详情视图中显示的网站的源试用信息。

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

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

源试用演示

了解详情