Web/API/CredentialsContainer/store

This is an experimental technologyCheck 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 successeful 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	Status	Comment
Credential Management Level 1	Working Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`store` Experimental'	Chrome Full support 51	Edge Full support ≤79	Firefox Full support Yes	IE No support No	Opera No support No	Safari ?	WebView Android Full support 51	Chrome Android Full support 51	Firefox Android Full support Yes	Opera Android No support No	Safari iOS ?	Samsung Internet Android Full support 5.0

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.

CredentialsContainer.store() by Mozilla Contributors is licensed under CC-BY-SA 2.5.