cookies
使扩展能够获取和设置 cookie，并在其更改时得到通知。
权限
要使用此 API，扩展必须在其 manifest.json 文件中指定“cookies” API 权限，以及针对希望访问 cookie 的任何站点的主机权限。扩展可以读取或写入任何可以被与主机权限匹配的 URL 读取或写入的 cookie。例如：
http://*.example.com/-
拥有此主机权限的扩展可以：
- 读取
www.example.com的任何路径下的非安全 cookie。 - 在
www.example.com的任何路径下写入安全或非安全 cookie。
它不能：
- 读取
www.example.com的安全 cookie。
- 读取
http://www.example.com/-
拥有此主机权限的扩展可以：
- 读取
www.example.com的任何路径下的非安全 cookie。 - 读取
.example.com的任何路径下的非安全 cookie。 - 在
www.example.com的任何路径下写入安全或非安全 cookie。 - 在
.example.com的任何路径下写入安全或非安全 cookie。
它不能：
- 读取或写入
foo.example.com的 cookie。 - 读取或写入
foo.www.example.com的 cookie。
- 读取
*://*.example.com/-
拥有此主机权限的扩展可以：
- 读取或写入任何路径下
www.example.com的安全或非安全 cookie。
- 读取或写入任何路径下
跟踪保护
跟踪器使用第三方 Cookie，即由与你当前所在网站不同的网站设置的 Cookie，来识别你访问的网站。例如：
- 你访问
a-shopping-site.com，该网站使用ad-tracker.com在网络上投放广告。ad-tracker.com设置了一个与ad-tracker.com域相关联的 Cookie。当你在a-shopping-site.com上时，ad-tracker.com会接收到你浏览的产品信息。 - 现在你访问了
a-news-site.com，该网站也使用ad-tracker.com投放广告。ad-tracker.com读取其 Cookie，并利用从a-shopping-site.com收集的信息来决定向你显示哪些广告。
Firefox 包含拦截跟踪的特性。这些特性会分隔 cookie，以使跟踪器无法关联所访问的网站。因此，在上述示例中，当访问 a-shopping-site.com 时，ad-tracker.com 无法看到在 a-news-site.com 上创建的 cookie。这种保护的首次实现是第一方隔离，现在正在被动态分区取代。
备注： 第一方隔离和动态分区不会同时生效。如果用户或扩展程序启用了第一方隔离，它将优先于动态分区。然而，当私密浏览使用动态分区时，普通浏览可能不会分隔 cookie。有关详细信息，请参阅 Firefox 中分区的状态。
存储分区
在使用动态分区时，Firefox 通过顶级站点分隔 JavaScript API 可访问的存储，同时为了满足常见用例而提供适当的对未分区的存储的访问。此功能正在逐步推出。有关实施详细信息，请参阅 Firefox 中分区的状态。
存储分区的键由顶级网站的 URL 构成，当动态分区处于激活状态时，键值通过 cookies API 中的 partitionKey.topLevelSite 属性获得，例如，partitionKey: {topLevelSite: "http://site"}。
通常，顶级文档位于未分区的存储中，而第三方 iframe 位于分区存储中。如果无法确定分区键，则使用默认值（未分区的存储）。例如，虽然所有 HTTP(S) 站点都可以用作分区键，但 moz-extension:- URL 不能。因此，Firefox 扩展文档中的 iframe 不使用分区存储。
默认情况下，cookies.get()、cookies.getAll()、cookies.set() 和 cookies.remove() 用于未分区的存储中的 cookie。要在这些 API 中使用分区存储中的 cookie，必须设置 partitionKey 中的 topLevelSite。唯一的例外是 getAll，其中设置 partitionKey 而不设置 topLevelSite 返回分区存储和未分区的存储中的 cookie。cookies.onChanged 对扩展程序可以访问的任何 cookie 都会触发，包括分区存储中的 cookie。为确保修改正确的 cookie，扩展应从事件中读取 cookie.partitionKey 属性，并将其值传递给 cookies.set() 和 cookies.remove()。
第一方隔离
当第一方隔离开启时，cookie 由用户访问的原始页面的域来限定（基本上是用户在 URL 栏中看到的域，也称为”第一方域“）。
用户可以通过调整浏览器的配置来启用第一方隔离，扩展可以使用 privacy API 中的firstPartyIsolate 这个设置来启用第一方隔离。请注意，在 Tor 浏览器中，默认情况下启用了第一方隔离。
在 cookies API 中，第一方域使用 firstPartyDomain 属性表示。在第一方隔离开启时设置的所有 cookie 都将该属性设置为原始页面的域。在上述示例中，一个 cookie 的域为 a-shopping-site.com，另一个为 a-news-site.com。当第一方隔离关闭时，由网站设置的所有 cookie 都将该属性设置为空字符串。
cookies.get()、cookies.getAll()、cookies.set() 和 cookies.remove() API 都接受 firstPartyDomain 选项。
当第一方隔离开启时，你必须提供此选项，否则 API 调用将失败并返回一个被拒绝的 promise。对于 get()、set() 和 remove()，你必须传递一个字符串值。对于 getAll()，你也可以在此处传递 null，这将获取所有 cookie，无论它们是否具有非空值的 firstPartyDomain。
当第一方隔离关闭时，firstPartyDomain 参数是可选的，并且默认为一个空字符串。可以使用非空字符串来检索或修改第一方隔离 cookie。同样，将 null 作为 firstPartyDomain 传递给 getAll() 将返回所有 cookie。
类型
-
表示有关 HTTP cookie 的信息。
-
表示浏览器中的一个 cookie 存储。
-
表示 cookie 更改的原因。
-
表示 cookie 的同站状态。
方法
-
检索有关单个 cookie 的信息。
-
检索与给定一组过滤器匹配的所有 cookie。
-
使用给定的 cookie 数据设置 cookie；如果存在等效的 cookie，则可能会覆盖它们。
-
按名称删除 cookie。
-
列出所有现有的 cookie 存储。
事件处理器
-
当设置或移除 cookie 时触发。
浏览器兼容性
BCD tables only load in the browser
示例扩展
备注：
此 API 基于 Chromium 的 chrome.cookies。此文档衍生自 Chromium 代码中的 cookies.json。