Document: hasUnpartitionedCookieAccess() メソッド

hasUnpartitionedCookieAccess() は Document インターフェイスのメソッドで、論理値を返すプロミス (Promise) を返します。これはこの文書がサードパーティの分離されていないクッキーへのアクセス権があるかどうかを示します。

このメソッドはストレージアクセス API の一部です。

このメソッドは Document.hasStorageAccess() の新しい名前です。

構文

js
hasUnpartitionedCookieAccess()

引数

なし。

返値

文書がサードパーティクッキーにアクセスできるかどうかを示す論理値で解決する Promise です。サードパーティクッキーにアクセスできる場合は true、できない場合は false です。

詳しくは Document.hasStorageAccess() を参照してください。

例外

InvalidStateError DOMException

現在の Document がまだアクティブでない場合に発生します。

例

js
document.hasUnpartitionedCookieAccess().then((hasAccess) => {
  if (hasAccess) {
    // ストレージへのアクセスはすでに許可されています。
    console.log("クッキーへのアクセスが許可されました");
  } else {
    // ストレージへのアクセスはまだ許可されていません。
    // requestStorageAccess() を呼び出す必要があります。
    console.log("クッキーへのアクセスが拒否されました");
  }
});

メモ: より完全な例は、ストレージアクセス API の使用を参照してください。

仕様書

Specification
Extending Storage Access API (SAA) to non-cookie storage
# dom-document-hasunpartitionedcookieaccess

ブラウザーの互換性

BCD tables only load in the browser

関連情報