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
.
Note: 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
that resolves to undefined
.
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 # dom-credentialscontainer-store |
Browser compatibility
BCD tables only load in the browser