文档:hasUnpartitionedCookieAccess() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

此方法是 Storage Access API 的一部分。

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

语法

js
hasUnpartitionedCookieAccess()

参数

无。

返回值

一个 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");
  }
});

注意:有关更完整的示例,请参阅使用 Storage Access API

规范

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

浏览器兼容性

另见