ContextQMD
Back to Content

Document: hasUnpartitionedCookieAccess() method

files/en-us/web/api/document/hasunpartitionedcookieaccess/index.md

latest1.9 KB
Original Source

{{APIRef("Storage Access API")}}

The hasUnpartitionedCookieAccess() method of the {{domxref("Document")}} interface returns a {{jsxref("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.

This method is a new name for {{DOMxRef("Document.hasStorageAccess()")}}.

Syntax

js-nolint
hasUnpartitionedCookieAccess()

Parameters

None.

Return value

A {{jsxref("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.

See {{DOMxRef("Document.hasStorageAccess()")}} for more details.

Exceptions

  • InvalidStateError {{domxref("DOMException")}}
    • : Thrown if the current {{domxref("Document")}} is not yet active.

Examples

js
document.hasUnpartitionedCookieAccess().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

{{Specifications}}

Browser compatibility

{{Compat}}

See also