This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The hasStorageAccess()
method of the Document
interface returns a Promise
that resolves with a boolean value indicating whether the document has access to its first-party storage.
See Storage Access API for more information.
Syntax
var promise = document.hasStorageAccess();
Parameters
None.
Return value
A Promise
that resolves with a boolean value indicating whether the document has access to its first-party storage.
If the promise gets resolved and a user gesture event was being processed when the function was originally called, the resolve handler will run as if a user gesture was being processed, so it will be able to call APIs that require user activation.
Examples
document.hasStorageAccess().then(hasAccess => { if (hasAccess) { // storage access has been granted already. } else { // storage access hasn't been granted already; // you may want to call requestStorageAccess(). } });
Specifications
The API is currently only at the proposal stage — the standardization process has yet to begin. You can currently find specification details of the API at Apple's Introducing Storage Access API blog post, and WHATWG HTML issue 3338 — Proposal: Storage Access API.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
hasStorageAccess | Chrome No support No | Edge No support No | Firefox Full support 65 | IE No support No | Opera No support No | Safari Full support 11.1 | WebView Android No support No | Chrome Android No support No | Firefox Android
Full support
65
| Opera Android No support No | Safari iOS Full support 11.3 | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- User must explicitly enable this feature.
- User must explicitly enable this feature.