Document: hasPrivateToken() method

The hasPrivateToken() method of the 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 Promise that resolves with a boolean value indicating whether the browser has a private state token stored from the specified issuer server.

Exceptions

• InvalidStateError DOMException
  • : Thrown if the current Document is not yet active.
• NotAllowedError DOMException
  • : Thrown if:
    • The current Document is not loaded in a secure context.
    • The maximum number of issuers per top level origin (two) has been exceeded.
• 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

Browser compatibility

See also

• Private State Token API