PasswordCredential: PasswordCredential() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Der PasswordCredential() Konstruktor erstellt ein neues PasswordCredential-Objekt. In unterstützenden Browsern kann eine Instanz dieser Klasse das credential aus dem init-Objekt für den globalen fetch() übergeben bekommen.

Syntax

js
new PasswordCredential(data)
new PasswordCredential(form)

Parameter

Eines der folgenden:

data

Ein Objekt mit den folgenden Eigenschaften:

iconURL Optional

Ein String, der die URL eines Icons oder Avatars darstellt, das mit den Anmeldeinformationen verknüpft werden soll.

id

Ein String, der eine eindeutige ID für die Anmeldeinformationen darstellt.

name Optional

Ein String, der den Benutzernamen der Anmeldeinformationen darstellt.

origin

Ein String, der die Herkunft der Anmeldeinformationen darstellt. PasswordCredential-Objekte sind herkunftsgebunden, was bedeutet, dass sie nur an dem spezifischen Herkunftsbereich verwendet werden können, für den sie bestimmt sind.

password

Ein String, der das Passwort der Anmeldeinformationen darstellt.

form

Ein Verweis auf ein HTMLFormElement mit geeigneten Eingabefeldern. Das Formular sollte mindestens eine ID und ein Passwort enthalten. Es könnte auch ein CSRF-Token erforderlich sein.

Ausnahmen

TypeError

Wird ausgelöst, wenn eine der Optionen id, origin oder password leer ist.

Beispiele

Dieses Beispiel zeigt, wie man ein HTMLFormElement einrichtet, um Daten zu erfassen, die wir verwenden, um ein PasswordCredential-Objekt zu erstellen.

Beginnen Sie mit dem Formularelement.

html
<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>

Dann eine Referenz zu diesem Formularelement, die verwendet wird, um ein PasswordCredential-Objekt zu erstellen und es im Passwortsystem des Browsers zu speichern.

js
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.
});

Spezifikationen

Specification
Credential Management Level 1
# dom-passwordcredential-passwordcredential
Credential Management Level 1
# dom-passwordcredential-passwordcredential-data

Browser-Kompatibilität

BCD tables only load in the browser