CredentialsContainer.store()

Experimental

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The store() method of the CredentialsContainer stores a set of credentials for the user inside a Credential instance, returning this in a Promise.

This method is restricted to top-level contexts. Calls to it within an <iframe> element will resolve without effect.

Syntax

CredentialsContainer.store(Credential).then(function(Credential) { ... } )

Parameters

Credentials
A valid Credential instance.

Returns

A Promise, resolving to the passed Credential instance.

Example

Storing a password credential at successful authentication

This code would be executed after a user signs up or logs in and the server confirms the credential is correct.

// Check if the browser supports password credentials (and the Credential Management API)
if ("PasswordCredential" in window) {
  let credential = new PasswordCredential({
    id: "example-username",
    name: "John Doe", // In case of a login, the name comes from the server.
    password: "correct horse battery staple"
  });

  navigator.credentials.store(credential).then(() => {
    console.info("Credential stored in the user agent's credential manager.");
  }, (err) => {
    console.error("Error while storing the credential: ", err);
  });
}

Specifications

Specification
Credential Management Level 1 (Credential Management 1)
# dom-credentialscontainer-store

Browser compatibility

BCD tables only load in the browser