课程大纲 第 117 课,共 156 课 · 浏览器是怎样做决定的
浏览器是怎样做决定的

Storage Access API

为什么重要 屏蔽第三方 Cookie 或对它们分区能阻止跟踪者,但它也会让你从诚实的嵌入内容中被登出:一个你已登录的评论框、一个知道你账号的视频播放器、另一个页面里面的一张登录表单。Storage Access API 就是浏览器让这些嵌入内容重新工作、同时让你掌控的方式。

再想想衣帽间。现在每家商店都有自己的号牌本,所以你在 AdCo 自己大楼里的主号牌在 ShopA 里面毫无用处。Storage Access API 就是 ShopA 的衣帽间服务员问你:“你想在这里使用你的主号牌吗?”如果你说是,那么在那一家商店里的那一位服务员就可以使用它。

Storage Access API:一项浏览器功能,它让一个来自另一个网站的嵌入框架能够请求访问它自己未分区的 Cookie,也就是你直接访问它时它拥有的那些。

用户手势:你在页面里做出的一个真实动作,比如一次点击或一次按键。浏览器把它当作证明,表明一个请求不是由脚本悄悄发出的。

嵌入内容如何请求

想象 comments.example 被嵌入在 blog.example 上。在它的框架里面,它的脚本会这样做(JavaScript,只是展示给你读的):

// Inside the comments.example frame
if (!(await document.hasStorageAccess())) {
  signInButton.onclick = async () => {        // must run inside a click
    try {
      await document.requestStorageAccess();     // the browser may ask you
      location.reload();                         // now it sees its own cookies
    } catch {
      showMessage("Open comments.example to sign in");
    }
  };
}

hasStorageAccess() 回答的是“我在这里已经拿到我的 Cookie 了吗?”requestStorageAccess() 请求得到它们,结果要么成功,要么失败。一个写得好的嵌入内容会优雅地处理失败的情况。

引擎应用的规则

  • 只有嵌入的框架才能请求。一个顶层页面本来就有它自己的 Cookie。
  • 需要一个用户手势。脚本不能在页面加载时悄悄地请求访问;它必须发生在你的点击之中。
  • 你可能需要认识这个嵌入内容。引擎可以要求你之前直接访问过这个被嵌入的网站,这样一个你从没听说过的跟踪者就没法提出请求。比如 Safari 就有这个要求。
  • 浏览器可能会显示一个提示,说出两个网站的名字,而你可以拒绝。
  • 授权的范围很窄。它们覆盖的是一个顶层站点上的一个被嵌入的网站,而且会在一段时间后过期。
  • 沙箱化的框架需要页面用 allow-storage-access-by-user-activation 这个沙箱令牌明确地允许它。

具体的提示和时间限制在各个引擎之间有所不同,而且会随时间变化;上面的这个形状是所有引擎共有的。

它在哪里上线了

Storage Access API 已在 Safari、Firefox 和 Chrome 中上线(Chrome 从 119 版起)。在 Chrome 中,它只对那些屏蔽了第三方 Cookie 的用户才重要,因为其他所有人仍然拥有未分区的第三方 Cookie。Related Website Sets 曾经会在同一家公司拥有的网站之间自动授予访问权限,它已经被撤下了(2026 年 10 月核实)。

Storage Access 对比 CHIPS

这两者很容易混淆。使用 CHIPS(第 1 阶段讲过的 Partitioned 属性)时,一个嵌入内容会在每个网站上接受一个单独的罐子,不需要任何许可。使用 Storage Access 时,嵌入内容请求的是它那一个共享的罐子,它能在不同网站上认出你,所以它需要你的手势,可能还需要你说“是”。当嵌入内容不需要知道你在别处是谁时,优先选择 CHIPS。

一个常见的误解

“授予存储访问权限会让嵌入内容读取页面的 Cookie。”它不会。comments.example 拿回的是它自己的 Cookie,而不是 blog.example 的任何东西。你同意的是 comments.example 可以在这个博客上认出你。

回顾

  • Storage Access API 让一个嵌入内容能请求它自己未分区的 Cookie。
  • 它需要一个用户手势,只在框架里有效,可能会提示你,并且只为一个网站上的一个嵌入内容授予有限时间的访问。
  • 它已在 Safari、Firefox 和 Chrome 119 中上线;在 Chrome 中,只有当第三方 Cookie 被屏蔽时它才重要(2026 年 10 月核实)。
  • CHIPS 无需许可就为每个网站提供一个单独的罐子;Storage Access 在你同意的情况下提供那个共享的罐子。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。