Document: hasUnpartitionedCookieAccess() 方法

hasUnpartitionedCookieAccess() 方法是 Document 接口的一部分,它返回一个 Promise,该 Promise 解析为一个布尔值,指示文档是否可以访问 第三方未分区 的 Cookie。

此方法是 存储访问 API 的一部分。

此方法是 Document.hasStorageAccess() 的新名称。

语法

js
hasUnpartitionedCookieAccess()

参数

无。

返回值

一个 Promise,该 Promise 解析为一个布尔值,指示文档是否可以访问第三方 Cookie - 如果可以访问则为 true,否则为 false

有关详细信息,请参阅 Document.hasStorageAccess()

异常

InvalidStateError DOMException

如果当前的 Document 尚未激活,则抛出此异常。

示例

js
document.hasUnpartitionedCookieAccess().then((hasAccess) => {
  if (hasAccess) {
    // storage access has been granted already.
    console.log("cookie access granted");
  } else {
    // storage access hasn't been granted already;
    // you may want to call requestStorageAccess().
    console.log("cookie access denied");
  }
});

注意:有关更完整的示例,请参阅 使用存储访问 API

规范

规范
将存储访问 API (SAA) 扩展到非 Cookie 存储
# dom-document-hasunpartitionedcookieaccess

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见