CredentialsContainer: store() 方法

安全上下文： 此功能仅在 安全上下文（HTTPS）中可用，在某些或所有 支持的浏览器 中可用。

store() 方法是 CredentialsContainer 的一个方法，它将一组凭据存储在 Credential 实例中，并以 Promise 的形式返回该实例。

注意： 此方法仅限于顶级上下文。 在 <iframe> 元素中调用它将解析而不会产生任何效果。

语法

js
store(credentials)

参数

credentials

一个有效的 Credential 实例。

返回值

一个解析为 undefined 的 Promise。

异常

NotAllowedError DOMException

如果存在与当前操作中类型相同的凭据，则抛出此异常。

示例

在成功认证后存储密码凭据

此代码将在用户注册或登录后执行，服务器确认凭据正确。

js
// Check if the browser supports password credentials (and the Credential Management API)
if ("PasswordCredential" in window) {
  let credential = new PasswordCredential({
    id: "example-username",
    name: "Carina Anand", // 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);
    },
  );
}

规范

规范
凭据管理级别 1
# dom-credentialscontainer-store

浏览器兼容性

BCD 表格仅在浏览器中加载