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 で見ることができます。

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
基本対応
実験的非標準
Chrome 未対応 なしEdge 未対応 なしFirefox 完全対応 65
無効
完全対応 65
無効
無効 From version 65: this feature is behind the dom.storage_access.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 未対応 なしOpera 未対応 なしSafari 完全対応 11.1
補足
完全対応 11.1
補足
補足 Currently only available on macOS High Sierra 10.13.4 beta, and in Safari Technology Preview 47+.
WebView Android 未対応 なしChrome Android 未対応 なしEdge Mobile 未対応 なしFirefox Android 完全対応 65
無効
完全対応 65
無効
無効 From version 65: this feature is behind the dom.storage_access.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 未対応 なしSafari iOS 完全対応 11.1
補足
完全対応 11.1
補足
補足 Currently only available on iOS 11.3 beta.
Samsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。

関連情報

Storage Access API

ドキュメントのタグと貢献者

このページの貢献者: mfuji09
最終更新者: mfuji09,