大网数据广告活动
Web 标准与前端开发

Document:hasStorageAccess() 方法

· 52CE 我爱测

Document 接口的 **`hasStorageAccess()`** 方法返回一个会兑现为指示文档是否有权访问第三方未分区 cookie 的布尔值的 Promise。

Storage Access API

Document 接口的 hasStorageAccess() 方法返回一个会兑现为指示文档是否有权访问第三方未分区 cookie 的布尔值的 Promise。

此方法属于存储访问 API。

[!NOTE] 此方法是 Document.hasUnpartitionedCookieAccess() 的别名。目前没有计划删除此方法而采用 Document.hasUnpartitionedCookieAccess()。

语法

hasStorageAccess()

参数

无。

返回值

一个 Promise,会兑现一个指示文档是否有权访问第三方 cookie 的布尔值——如果可以,则返回 true,否则返回 false。

在以下几种情况下,此方法返回的结果可能不准确:

  1. 用户可能激活了浏览器的阻止第三方 cookie 的设置;在这种情况下,即使第三方 cookie 仍然无法访问,也可能返回 true。要处理这种情况,你应该优雅地处理由于无法检索 cookie 值而导致的任何错误;例如,通知用户他们的个性化设置被阻止访问,并邀请他们重新登录以使用这些设置。
  2. 浏览器可能不会默认阻止第三方 cookie 的访问;在这种情况下,即使第三方 cookie 可以访问,也可能返回 false,并且不需要请求存储访问权限(例如通过 Document.requestStorageAccess())。要解决这个问题,你可以查询 Document.cookie 来确定是否可以访问 cookie,如果不可访问,则调用 Document.requestStorageAccess()。

[!NOTE] 如果 promise 得到兑现,并且在最初调用函数时正在处理用户手势事件,则兑现处理器运行的时候就好像正在处理用户手势,因此它将能够调用需要用户激活的 API。

异常

  • InvalidStateError DOMException
    • : 如果当前Document尚未激活,则抛出此异常。

示例

document.hasStorageAccess().then((hasAccess) => {
  if (hasAccess) {
    // 已获得存储访问权限。
    console.log("已获得 cookie 访问权限");
  } else {
    // 尚未获得存储访问权限;你可能需要调用 requestStorageAccess()。
    console.log("尚未获得 cookie 访问权限");
  }
});

[!NOTE] 参见使用存储访问 API 以获取更完整的示例。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。