Document.hasStorageAccess()
Experimental: 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
BCD tables only load in the browser