大网数据广告活动
Web 标准与前端开发

PasswordCredentialInit

· 52CE 我爱测

The **`PasswordCredentialInit`** dictionary represents the object passed to CredentialsContainer.create() as the value of the `password` option, when creating a password credential.

Credential Management API

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
    • : 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.

Examples

Creating a password credential from an object literal

This example constructs an object literal to initialize a password credential.

const credInit = {
  id: "serpent1234", // "username" in a typical username/password pair
  name: "Serpentina", // display name for credential
  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.id);
  // serpent1234
  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="displayname">Enter your display name: </label>
    <input
      type="text"
      name="displayname"
      id="displayname"
      autocomplete="name" />
  </div>
  <div>
    <label for="username">Enter your username: </label>
    <input type="text" name="username" id="username" autocomplete="username" />
  </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>
form {
  display: table;
}

div {
  display: table-row;
}

label,
input {
  display: table-cell;
  margin-bottom: 10px;
}

label {
  padding-right: 10px;
}

#log {
  height: 60px;
  padding: 0.5rem;
  border: 1px solid black;
}

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:\ndisplay name: ${credential.name}, username: ${credential.id}, 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

Creating a password credential from a form

Specifications

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。