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 vor der Verwendung auf produktiven Webseiten.

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 vom init Objekt für das globale fetch() übergeben werden.

Syntax

js
new PasswordCredential(data)
new PasswordCredential(form)

Parameter

Einer der folgenden:

data

Ein Objekt mit den folgenden Eigenschaften:

iconURL Optional

Ein String, der die URL eines Symbols oder Avatars darstellt, das mit den Zugangsdaten in Verbindung gebracht werden soll.

id

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

name Optional

Ein String, der den Benutzernamen der Zugangsdaten darstellt.

origin

Ein String, der den Ursprung der Zugangsdaten darstellt. PasswordCredential Objekte sind ursprungsgebunden, was bedeutet, dass sie nur am angegebenen Ursprung verwendet werden können, für den sie vorgesehen sind.

password

Ein String, der das Passwort der Zugangsdaten darstellt.

form

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

Ausnahmen

TypeError

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

Beispiele

Dieses Beispiel zeigt, wie ein HTMLFormElement eingerichtet wird, um Daten zu erfassen, die wir zur Erstellung eines PasswordCredential Objekts verwenden werden.

Angefangen 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 ein Verweis auf dieses Formularelement, das genutzt 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