Document: hasStorageAccess() method

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.

Syntax

hasStorageAccess()

Parameters

None.

Return value

A 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:

1. The user may have active browser settings that block third-party cookies; in this case, 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.
2. The browser might not block third-party cookie access by default; in this case, 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.

Exceptions

InvalidStateError DOMException

Thrown if the current Document is not yet active.

Examples

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");
  }
});

Specifications

Browser compatibility

See also

• Document.hasUnpartitionedCookieAccess(), Document.requestStorageAccess(), Document.requestStorageAccessFor()
• Using the Storage Access API
• Introducing Storage Access API (WebKit blog)