Document: hasStorageAccess() メソッド

構文

hasStorageAccess()

引数

なし。

返値

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

このメソッドが返す結果は、状況によっては不正確なことがあります。

1. ユーザーがサードパーティクッキーをブロックするブラウザー設定をアクティブにしている場合があります。この場合、サードパーティのクッキーにはまだアクセスできないにもかかわらず、true が返されるかもしれません。このような状況を処理するには、クッキーの値が回復不可能になるようなエラーを適切に処理しなければなりません。例えば、個人設定へのアクセスがブロックされていることをユーザーに知らせ、それを使用するには再度サインインするよう促してください。
2. ブラウザーは既定で、サードパーティクッキーへのアクセスをブロックしない場合があります。この場合、サードパーティクッキーがアクセス可能であっても false が返されるかもしれませんし、ストレージへのアクセスは（つまり Document.requestStorageAccess() を通して）リクエストされる必要はないでしょう。この課題を回避するには、Document.cookie に問い合わせてクッキーがアクセス可能かどうかを探し、アクセス可能でない場合は Document.requestStorageAccess() を呼び出します。

例外

InvalidStateError DOMException

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

例

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

仕様書

ブラウザーの互換性

関連情報

• Document.hasUnpartitionedCookieAccess(), Document.requestStorageAccess(), Document.requestStorageAccessFor()
• ストレージアクセス API の使用
• Introducing Storage Access API (WebKit blog)