Credential Management API
The PasswordCredential() constructor creates a new PasswordCredential object.
Syntax
new PasswordCredential(data)
new PasswordCredential(form)
Parameters
Either of the following:
-
data- : An object with the following properties:
iconURL- : A string representing the URL of an icon or avatar to be associated with the credential.
id- : A string representing the username portion of the username/password combination.
name- : A string representing a human-understandable name associated with the credential, intended to help the user select this credential in a user interface.
origin- : A string representing the credential's origin. PasswordCredential objects are origin-bound, which means that they will only be usable on the specified origin they were intended to be used on.
password- : A string representing the credential password.
- : An object with the following properties:
-
form- : 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.
Exceptions
- TypeError
- : Thrown if one of the
id,originorpasswordoption is empty.
- : Thrown if one of the
Examples
This example shows how to set up an HTMLFormElement to capture data which we'll use to create a PasswordCredential object.
Starting with the form element.
<form id="form" method="post">
<label for="id">Username:</label>
<input type="text" name="id" autocomplete="username" />
<label for="password">Password:</label>
<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.
const form = document.querySelector("#form");
const creds = new PasswordCredential(form);
// Store the credentials.
navigator.credentials.store(creds).then((creds) => {
// Do something with the credentials if you need to.
});
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
