PasswordCredentialInit
The PasswordCredentialInit
dictionary represents the object passed to CredentialsContainer.create()
as the value of the password
option, when creating a password credential.
Initialization from a form
Instead of passing this dictionary directly, a website can pass an HTMLFormElement
, and the implementation of create()
will populate the credential's data from the values of the form's submittable elements, based on the value of the element's autocomplete
attribute.
autocomplete value |
Credential property targeted |
---|---|
"username" |
id |
"name" or "nickname" |
name |
"new-password" or "current-password" |
password |
"photo" |
iconURL |
If the form contains both "new-password"
and "current-password"
elements, the value for "new-password"
will be used.
The origin
property is set to the origin of the document the HTMLFormElement
is contained within.
Instance properties
iconURL
Optional-
A string representing the URL of an icon or avatar to be associated with the credential.
id
-
A string representing a unique ID for the credential.
name
Optional-
A string representing the credential username.
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.
Examples
Creating a password credential from an object literal
This example constructs an object literal to initialize a password credential.
const credInit = {
id: "1234",
name: "Serpentina",
origin: "https://example.org",
password: "the last visible dog",
};
const makeCredential = document.querySelector("#make-credential");
makeCredential.addEventListener("click", async () => {
const cred = await navigator.credentials.create({
password: credInit,
});
console.log(cred.name);
// Serpentina
console.log(cred.password);
// the last visible dog
});
Creating a password credential from a form
This example uses a form to initialize a password credential.
HTML
The HTML declares a <form>
containing three submittable elements, representing the user ID, user's display name, and password.
<form>
<div>
<label for="userid">Enter your user ID: </label>
<input type="text" name="userid" id="userid" autocomplete="username" />
</div>
<div>
<label for="username">Enter your username: </label>
<input type="text" name="username" id="username" autocomplete="name" />
</div>
<div>
<label for="password">Enter your password: </label>
<input
type="password"
name="password"
id="password"
autocomplete="new-password" />
</div>
</form>
<button id="make-credential">Make credential</button>
<pre id="log"></pre>
JavaScript
The JavaScript passes the form into create()
, and logs some of the values of the resulting credential.
The promise returned by create()
will reject if the form does not contain values for the mandatory credential properties.
const makeCredential = document.querySelector("#make-credential");
const formCreds = document.querySelector("form");
makeCredential.addEventListener("click", async () => {
try {
const credential = await navigator.credentials.create({
password: formCreds,
});
log(
`New credential:\nname: ${credential.name}, password: ${credential.password}`,
);
} catch (e) {
if (e.name === "TypeError") {
log("Error creating credential\nMake sure you filled in all the fields");
}
}
});
const logElement = document.querySelector("#log");
function log(text) {
logElement.innerText = text;
}
Result
Specifications
Specification |
---|
Credential Management Level 1 # typedefdef-passwordcredentialinit |