PasswordCredential

The PasswordCredential constructor creates a new PasswordCredential object. In supporting browsers an instance of this class may be passed in the credential member of the init object for global fetch.

Syntax

var myCredential = new PasswordCredential(passwordCredentialData)
var myCredential = new PasswordCredential(HTMLFormElement)

Parameters

Either one of the following:

passwordCredentialData 

A PasswordCredentialData dictionary containing the following fields:

• iconURL: (Optional) the URL of a user 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 least contain an id and password, but can also include a CSRF token.

Examples

The following example shows how to set up an HTMLFormElement to caputure data which we'll then use to create a PasswordCredential object.

First, 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>

Next, get a reference to that form element, use it to create a PasswordCredential object and store 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

Browser compatibility