Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

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 Icons oder Avatars darstellt, welches mit dem Credential verknüpft wird.

id

Ein String, der eine eindeutige ID für das Credential darstellt.

name Optional

Ein String, der den Benutzernamen des Credentials darstellt.

origin

Ein String, der die Herkunft des Credentials darstellt. PasswordCredential Objekte sind herkunftsgebunden, was bedeutet, dass sie nur an dem angegebenen Ursprung nutzbar sind, für den sie vorgesehen sind.

password

Ein String, der das Password des Credentials 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 erfordern.

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.

Beginnend 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, um es zu nutzen, 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