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
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
oderpassword
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.
<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.
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 |