Baseline 2023
Newly available
The hasStorageAccess()
method of the Document
interface returns a Promise
that resolves with a boolean value indicating whether the document has access to third-party, unpartitioned cookies.
This method is part of the Storage Access API.
Note: This method is another name for Document.hasUnpartitionedCookieAccess()
. There are no current plans to remove this method in favor of Document.hasUnpartitionedCookieAccess()
.
None.
Return valueA Promise
that resolves with a boolean value indicating whether the document has access to third-party cookies â true
if it does, and false
if not.
The result returned by this method can be inaccurate in a couple of circumstances:
true
may be returned even though third-party cookies are still inaccessible. To handle such a situation, you should gracefully handle any errors resulting in cookie values being unretrievable; for example, inform the user that access to their personalized settings is blocked and invite them to sign in again to use them.false
may be returned even though third-party cookies are accessible, and storage access wouldn't need to be requested (i.e., via Document.requestStorageAccess()
). To get around this issue, you could query Document.cookie
to find out whether your cookies are accessible, and call Document.requestStorageAccess()
if they are not.Note: 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.
ExceptionsInvalidStateError
DOMException
Thrown if the current Document
is not yet active.
document.hasStorageAccess().then((hasAccess) => {
if (hasAccess) {
// storage access has been granted already.
console.log("cookie access granted");
} else {
// storage access hasn't been granted already;
// you may want to call requestStorageAccess().
console.log("cookie access denied");
}
});
Note: See Using the Storage Access API for a more complete example.
Specifications Browser compatibility See alsoRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4