MDN self-hosted library · e01.org

Document: hasPrivateToken() method

Storage Access API

Storage Access API

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