Document: hasPrivateToken() method

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

The hasPrivateToken() method of the {{domxref("Document")}}Document interface returns a promise that fulfills with a boolean indicating whether the browser has a private state token stored from a particular issuer server.

Syntax

hasPrivateToken(issuer)

Parameters

• issuer
  • : A string representing the URL of an issuer server.

Return value

A {{jsxref("Promise")}}Promise that resolves with a boolean value indicating whether the browser has a private state token stored from the specified issuer server.

Exceptions

• InvalidStateError {{domxref("DOMException")}}DOMException
  • : Thrown if the current {{domxref("Document")}}Document is not yet active.
• NotAllowedError {{domxref("DOMException")}}DOMException
  • : Thrown if:
    • The current {{domxref("Document")}}Document is not loaded in a secure context.
    • The maximum number of issuers per top level origin (two) has been exceeded.
• {{jsxref("TypeError")}}TypeError
  • : Thrown if issuer is not a valid URL.

Examples

const hasToken = await Document.hasPrivateToken(`issuer.example`);
if (!hasToken) {
  await fetch(
    "https://issuer.example/.well-known/private-state-token/issuance",
    {
      method: "POST",
      privateToken: {
        version: 1,
        operation: "token-request",
      },
    },
  );
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Private State Token API