在 Microsoft Edge 中使用源试用版

使用源试用版在有限的一段时间内在你自己的实时网站上试用实验性 API。 使用源试用版时,访问站点的 Microsoft Edge 用户可以运行使用实验性 API 的代码。

若要查看可用源试用版的列表并注册源以试用任何源试用版,请参阅 Microsoft Edge Origin 试用版。 若要评估在网站上使用实验性 API 的适用性,检查 Microsoft Edge 的最低版本要求,并检查试用到期日期。

可以使用浏览器功能存储库中的“ 问题 ”选项卡,向浏览器功能工程师和 Web 标准社区提供有关功能 API 的设计、用例或使用功能 API 的体验的反馈。

源试用令牌的工作原理

源试用机制允许网页的用户在其Microsoft Edge 浏览器中使用源试用版的实验性功能 API,尽管该功能处于默认状态。 用户的 Microsoft Edge 浏览器会检测源试用版的令牌,然后自动打开浏览器的功能标志,该标志对应于令牌有效的源试用版。 用户无需在 Microsoft Edge 中设置任何 edge://flags 设置。

若要支持在网站中使用源试用版的实验性 API,请执行以下操作:

  1. 注册想要在 (上使用实验功能的源域, https://example.com 例如,) ,然后为你生成一个源试用令牌。

  2. 将令牌复制到元素内 <head>/<meta> 或 HTTP 服务器响应标头中的 Origin-Trial 网页。

  3. 当Microsoft Edge 用户访问你的网页并且浏览器找到源试用令牌时,浏览器会打开关联的源试用功能。

注册原始试用版

若要注册源试用版,请执行以下操作:

  1. 转到 Microsoft Edge Origin 试用版

    若要注册广告选择 API 源试用版,请参阅 注册广告选择 API

  2. 选择活动试用版。

  3. 单击“ 我接受使用条款” 按钮。

  4. 如果系统提示,请登录。 例如,登录到 GitHub,然后授权 Microsoft Edge Origin 试用版 页使用帐户登录。

    此时会打开 “新建源试用注册 ”窗体:

    “新建源试用注册”窗体

  5. 在“ ”文本框中,输入域 URL ((如 https://example.com) )或子域 URL ((如 https://beta.example.com) )。

    可以将源试用令牌配置为支持以下任何一项:

    • 单个域(例如 https://example.com),不支持其子域。
    • 单个子域,例如 https://beta.example.com
    • 域(如 https://example.com)及其子域(如 https://beta.example.com)。

    不支持尾随路径和查询参数。 如果输入的 URI 具有尾随路径或查询参数(例如 https://example.com/path/new-feature),则会注册根域 ((如 https://example.com) 或子域),并忽略任何尾随路径或查询参数。

  6. 设置 “为子域启用令牌?” 切换。

    • 若要在域 ((如 https://example.com) )上启用源试用版,而不支持其子域 ((如 https://beta.example.com) ),请确保“ 为子域启用令牌?” 开关已关闭。

    • 若要仅在特定的子域 ((例如 https://beta.example.com) )启用源试用版,请确保“ 为子域启用令牌?” 开关已关闭。

    • 若要启用在域 ((如 https://example.com) 及其子域 (如 https://beta.example.com) )使用源试用版,请打开 “为子域启用令牌?” 切换。

  7. 单击“ 提交 ”按钮。

    将生成一个源试用令牌,并显示在“新建源试用注册窗体附近的“注册”部分中:

    “注册”部分中显示的生成的令牌

  8. 单击“ 复制 ”按钮,然后将源试用令牌粘贴到安全位置,并指出它所在的域。 稍后还可以在此网页中查看此信息。

在网站上使用源试用令牌

通过以下任一方式在网站上使用令牌:

选项 1:<网页头<>元素中的元>标记

<head> 网页的 元素中,包含以下 <meta> 标记:

<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">

将 替换为 EXAMPLE_TOKEN 令牌。

选项 2:HTTP 服务器响应中的 HTTP 标头

在 HTTP 服务器响应中,添加以下 HTTP 标头:

Origin-Trial: EXAMPLE_TOKEN

将 替换为 EXAMPLE_TOKEN 令牌。

选择退出源试用试验

若要选择退出已注册的试验 (源试用版) ,请从 <meta> 标记或服务器响应标头中删除源试用令牌。

执行功能检测并提供正常回退

将起源试验视为实验性试验。 最佳做法是在网站代码中执行功能检测,并为以下情况提供正常回退:

  • 如果试验性功能 API 在用户的浏览器中不可用。
  • 如果源试用令牌过期。
  • 如果 Microsoft Edge 功能团队结束源试用。

请参阅在 MDN 上实现功能检测

在 处测试源试用版 localhost

若要在 中 localhost测试源试用功能,请转到 edge://flags 并打开相应的功能标志。

检测和使用 Microsoft Edge 源试用令牌的机制仅支持用于启用 SSL 的域,而不支持 。localhost

续订源试用令牌

默认情况下,源试用令牌将在 6 周内过期。 当源试用令牌过期时,必须续订令牌,这意味着为此源试用版生成新的令牌。 可以在令牌过期之前续订令牌。

若要续订源试用令牌,请执行以下操作:

  1. 转到 Microsoft Edge Origin 试用版

    有关广告选择 API 源试用版,请参阅 注册广告选择 API

  2. “我的已注册试用版 ”部分中,选择一个原始试用版。

  3. “注册 ”部分中,在包含 已过期 锁屏提醒的令牌行中,单击“ 续订 ”按钮:

    用于续订令牌的 UI

    将生成并显示新的令牌。

  4. 在包含新令牌的行中,单击“ 复制 ”按钮,然后将新令牌粘贴到代码中。

源试用的持续时间

原始试用版可能持续到计划的到期日期,也可以提前结束。

计划的到期日期

注册试用版后,令牌将一直有效,直到原始试用版的信息卡上显示的试用到期日期。 在源试用版的到期日期之后,令牌将不再有效,与源试用版关联的功能将被视为已准备好交付,否则将保留该功能以供进一步开发。

提前结束

Microsoft Edge 功能团队可能会决定在试用到期日期之前提前结束试验;例如:

  • 如果安全事件是由功能引起的。
  • 如果功能团队收集了足够的反馈,并得出结论认为当前建议的 API 不能满足 Web 开发人员的需求,并且需要进行重大重新设计。

如果实验提前结束,则拥有源试用版的功能团队会向在试验中注册的所有开发人员发送电子邮件。

提供有关源试用版的反馈

请提供有关试验功能的反馈。 该功能的 GitHub 存储库的“ 问题 ”选项卡允许公开讨论该功能的可用性和稳定性。

若要提供有关源试用版的反馈,请执行以下操作:

  1. 转到 Microsoft Edge Origin 试用版

  2. 选择活动试用版。

  3. 单击“ 反馈 ”按钮。 此时会打开产品的 GitHub 存储库的“ 问题 ”选项卡。

  4. 查看问题。

  5. 如果需要新问题,请单击“ 新建问题 ”按钮。

对于广告选择 API 源试用版,请参阅注册广告选择 API 中的提供有关源试用版的反馈

另请参阅

广告选择 API:

外部: