测试破损

为支持在 Chrome 中弃用第三方 Cookie 的 1% 测试和磨合阶段中的测试场景,我们提供了多个 Chrome 标志

在 Chrome 121 及更高版本中,您可以模拟逐步淘汰第三方 Cookie 后的状态:

  • 启用 chrome://flags/#test-third-party-cookie-phaseout
  • 使用标记 --test-third-party-cookie-phaseout 通过命令行运行 Chrome

这会将 Chrome 设置为屏蔽第三方 Cookie,并确保新功能和缓解措施均有效。

您还可以尝试使用 chrome://settings/cookies 屏蔽的第三方 Cookie 进行浏览,但请注意,该标记可确保新功能和更新后的功能也会启用。屏蔽第三方 Cookie 是检测问题的好方法,但不一定能帮助您确认问题是否已解决。

如果您为网站维护了一个处于活跃状态的测试套件,那么应该同时运行两个测试:一个运行采用常规设置,另一个采用 Chrome 设置,另一个运行采用 --test-third-party-cookie-phaseout 标志发布的相同 Chrome 版本。第二次运行(而非第一次)中的测试失败都非常适合调查第三方 Cookie 依赖关系。

用于测试不同场景的 Chrome 标志

除了 --test-third-party-cookie-phaseout 之外,还有许多标志可用于测试不同的场景,例如参与弃用试用

  • Windows、Mac、Linux、ChromeOS 和 Android 支持以下所有标志。
  • 您可以通过 chrome://flags 页面命令行设置这些标志。
  • 如需使用 --enable-features--disable-features 从命令行设置多项功能的标志,请在各个功能名称之间添加英文逗号分隔。
  • 您可以从 chrome://flags 中设置该标志,然后在 chrome://version 页面上查看命令行值,确定用于命令行标志的值。
名称 Purpose 最低版本 chrome://flags 命令行 flag
针对第三方 Cookie 的跟踪保护 已启用:开启跟踪保护
• 在地址栏(多功能框)中显示眼睛图标界面,以便用户暂时为网站启用第三方 Cookie。
• 提供 chrome://settings/trackingProtection,而不是 chrome://settings/cookies
121 #tracking-protection-3pcd --enable-features=TrackingProtection3pcd

--disable-features=TrackingProtection3pcd
测试逐步淘汰第三方 Cookie 已停用:这是默认值。(无效。)

已启用:限制第三方 Cookie 并启用跟踪保护界面,以便与逐步淘汰第三方 Cookie 后 Chrome 的行为保持一致。

此设置会覆盖 BlockThirdPartyCookies=false Chrome 企业版政策,但被内容设置(例如由 Storage Access APICookiesAllowedForUrls 政策授予的设置)所替换。

标志和设置描述了用户设置如何与此标志交互。
121 #test-third-party-cookie-phaseout --test-third-party-cookie-phaseout
用于测试的第三方 Cookie 弃用试用授权 已启用:这是默认值。允许参与第三方 Cookie 弃用试用。(此标志不再需要设置为“已启用”即可参与试用。)

已停用:即使 Chrome 未提供第三方弃用试用令牌,也会照常运行。换句话说:停用第三方弃用试用。这对于测试在参与弃用试用的网站上是否能够正常进行长期修复(没有第三方 Cookie)非常有用。

如需发挥作用,此标志需要启用 #tracking-protection-3pcd
121 #third-party-cookie-deprecation-trial --enable-features=TpcdSupportSettings

--disable-features=TpcdSupportSettings
用于测试的顶级第三方 Cookie 弃用试用授权 已启用:若要允许顶级第三方 Cookie 弃用试用,则必须启用。

已停用:与第三方试用一样,让 Chrome 按照尚未提供有效的试用令牌的行为方式(即使已提供该令牌)。换言之,就是停用第一方弃用试用。这对于测试在参与第一方弃用试用计划的网站上是否能够正常进行长期修复(没有第三方 Cookie)非常有用。
122 #top-level-third-party-cookie-deprecation-trial --enable-features=TopLevelTpcdSupportSettings

--disable-features=TopLevelTpcdSupportSettings
用于测试的第三方 Cookie 弃用元数据授权 已启用:这是默认值。允许第三方 Cookie 弃用试用宽限期生效。

已停用:让 Chrome 按照宽限期未生效的方式运行。 这可用于在宽限期结束之前(对于处于宽限期的网站)检查您的网站是否已正确部署弃用试用令牌。
121 #tpcd-metadata-grants --enable-features=TpcdMetadataGrants

--disable-features=TpcdMetadataGrants
逐步弃用第三方 Cookie 期间方便进行测试 已启用:这是默认值。允许为此 Chrome 客户端设置 Chrome 协助测试组实验组。

已停用:不允许 Chrome 设置实验组。

其他值:手动设置特定实验组。

大多数开发者都需要使用其中一种 Enabled Force 设置。这些测试会绕过资格检查,并以可预测的方式将 Chrome 客户端置于选定的实验组。Enabled 设置允许将客户端包含在实验组中,但不会强制包含。
121 #tpc-phase-out-facilitated-testing --enable-features=CookieDeprecationFacilitatedTesting

--disable-features=CookieDeprecationFacilitatedTesting

对于其他值,命令行值取决于设置。例如,如需设置 Enabled Force Control 1,请执行以下操作:

--enable-features=CookieDeprecationFacilitatedTesting:force_eligible/true/disable_3p_cookies/false/disable_ads_apis/false/label/fake_control_1%2E1/version/9994

如果您需要从命令行设置这些值,最简单的方法可能是通过 chrome://flags 设置值,重启浏览器,然后从 chrome://version 页面的 Command Line 部分复制标志值。
第三方 Cookie 授权启发式测试 默认:允许基于启发法的缓解措施

已启用:无效。(与默认相同)。

已停用:不允许使用基于启发法的缓解措施。这对于测试在没有启发法缓解措施的情况下,其他长期修复(无第三方 Cookie)是否按预期运行非常有用。

其他标志值如下所示。

CurrentInteraction:需要在弹出或重定向流程期间在第三方网站上进行互动。

ShortRedirect 重定向启发式算法会授予 Cookie 访问权限 15 分钟:对于重定向场景,允许使用第三方 Cookie,如基于启发法的缓解措施中所述。

LongRedirect:重定向启发式方法将 Cookie 访问权限授予 30 天。

MainFrame:只有主框架发起的弹出式窗口才能启用重定向启发法。

AllFrameInitiator
:由任何帧发起的弹出式窗口均可启用重定向启发法。
120 #tpcd-heuristics-grants --enable-features=TpcdHeuristicsGrants

--disable-features=TpcdHeuristicsGrants

对于其他值,请设置 chrome://flags 的值,重启浏览器,然后从 chrome://version 页面的命令行部分复制该标志值。

标志和设置

当您在已启用 chrome://flags#test-third-party-cookie-phaseout 标志的情况下使用 Chrome 时,通过 Chrome 用户设置屏蔽第三方 Cookie 会产生不同的效果。

仅启用此标记后,系统仍会像处理 Chrome 跟踪保护测试组一样处理第三方 Cookie:在短期有限的情况下,仍然允许使用第三方 Cookie,以便关键服务正常运行;此外,也可以通过 CHIPSStorage Access API 的长期解决方案使用第三方 Cookie。

如果已启用来自 chrome://settings/trackingProtection阻止所有第三方 Cookie(对于不在“跟踪保护”组中的用户),则 Chrome 不允许任何访问第三方 Cookie 或其他未分区状态的 chrome://settings/cookies 中的第三方 Cookie,除非 Chrome 企业版的 CookiesAllowedForUrls 政策允许第三方 Cookie,或者用户明确授予权限:

  • 使用地址栏(多功能框)中的眼睛图标。
  • chrome://settings/trackingProtection 页面上的允许使用第三方 Cookie 的网站下添加一个条目。
  • 在“chrome://settings/cookies”页面上向允许使用第三方 Cookie 添加一个条目。

如果将 Chrome 企业版用户的 BlockThirdPartyCookies 政策设为 false,他们将无法阻止来自 chrome://settings 的第三方 Cookie。

使用标志组合来模拟使用场景

场景 #tracking-protection-3pcd #third-party-cookie-deprecation-trial #tpcd-metadata-grants
1% 测试,已忽略弃用试用 已启用 已停用 已停用
域名的宽限期注册已获批准,但尚未提供令牌 已启用 已启用 已启用
宽限期有效,已提供令牌 已启用 已启用 已停用
宽限期不再有效(即 2024 年 4 月之后),已提供令牌 已启用 已启用 [无影响]

支持

了解详情