文件: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

瀏覽器相容性

另見