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 (Credential Management 1) # dom-credentialscontainer-store |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
store |
51 |
79 |
61 |
No |
38 |
13 |
51 |
51 |
61 |
41 |
13 |
5.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CredentialsContainer/store