Document.hasStorageAccess()

Document インターフェイスの hasStorageAccess() メソッドは、文書がファーストパーティのストレージへのアクセス権を持っているかどうかを真偽値で解決する Promise を返します。

詳しくは Storage Access API を参照してください。

構文

Promise<boolean> hasStorageAccess()

引数

なし。

返値

文書がファーストパーティのストレージへのアクセス権を持っているかどうかを真偽値で解決する Promise です。

ユーザーの操作イベントの処理中にこの関数が呼び出された場合、 Promise が解決されると、ユーザー操作が処理されたかのように解決ハンドラーが実行されるため、ユーザーによる有効化が必要な API を呼び出すことができます。

例

document.hasStorageAccess().then(hasAccess => {
  if (hasAccess) {
    // ストレージへのアクセスがすでに許可されている。
  } else {
    // まだストレージへのアクセスは許可されていない。
    // requestStorageAccess() を呼び出すと良いかもしれない。
  }
});

仕様書

この API はまだ提案段階にあります。 — 標準化プロセスはまだ始まっていません。現在のところ、この API の詳細の仕様書は、アップルのブログ投稿の Introducing Storage Access API、および WHATWG HTML issue 3338 — Proposal: Storage Access API で見ることができます。

ブラウザーの対応

関連情報

Storage Access API