Non-standard This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The PasswordCredential
constructor creates a new PasswordCredential
object. In supporting browsers, an instance of this class may be passed the credential
from the init
object for global fetch
.
Syntax
var myCredential = new PasswordCredential(passwordCredentialData) var myCredential = new PasswordCredential(HTMLFormElement)
Parameters
Either of the following:
- passwordCredentialData
- A PasswordCredentialData dictionary containing the following fields:
iconURL
- (Optional) the URL of a user's avatar image.
id
: The ID of the user signing in.name
: (Optional) The name of the user signing in.password
: The password of the user signing in.
- htmlFormElement
- A reference to an
HTMLFormElement
with appropriate input fields. The form should, at the very least, contain an id and password. It could also require a CSRF token.
Examples
This example shows how to set up an HTMLFormElement
to caputure data which we'll use to create a PasswordCredential
object.
Starting with the form element.
<form id="form" method="post">
<input type="text" name="id" autocomplete="username" />
<input type="password" name="password" autocomplete="current-password" />
<input type="hidden" name="csrf_token" value="*****" />
</form>
Then, a reference to this form element, using it to create a PasswordCredential
object, and storing it in the browser's password system.
var form = document.querySelector('#form');
var creds = new PasswordCredential(form);
// Store the credentials.
navigator.credentials.store(creds)
.then(function(creds) {
// Do something with the credentials if you need to.
});
Specifications
Specification | Status | Comment |
Credential Management Level 1 | Working Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 51 |
Edge
Full support ≤79 |
Firefox
? |
IE
No support No |
Opera
Full support 38 |
Safari
? |
WebView Android
Full support 51 |
Chrome Android
Full support 51 |
Firefox Android
? |
Opera Android
Full support 41 |
Safari iOS
? |
Samsung Internet Android
Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Non-standard. Expect poor cross-browser support.'
- Non-standard. Expect poor cross-browser support.
PasswordCredential by Mozilla Contributors is licensed under CC-BY-SA 2.5.