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
new PasswordCredential(data)
new PasswordCredential(form)
Parameter
Entweder der Folgenden:
data-
Ein Objekt mit den folgenden Eigenschaften:
iconURLOptional-
Ein String, der die URL eines Symbols oder Avatars darstellt, das mit dem Berechtigungsnachweis verknüpft werden soll.
id-
Ein String, der den Benutzernamen des Benutzername/Passwort-Kombination darstellt.
nameOptional-
Ein String, der einen für Menschen verständlichen Namen darstellt, der mit dem Berechtigungsnachweis verknüpft ist und dem Benutzer dabei helfen soll, diesen Berechtigungsnachweis in einer Benutzeroberfläche auszuwählen.
origin-
Ein String, der den Ursprung des Berechtigungsnachweises darstellt.
PasswordCredentialObjekte sind ursprungsgebunden, was bedeutet, dass sie nur auf dem spezifizierten Ursprung nutzbar sind, für den sie bestimmt sind. password-
Ein String, der das Passwort des Berechtigungsnachweises darstellt.
form-
Ein Verweis auf ein
HTMLFormElementmit geeigneten Eingabefeldern. Das Formular sollte zumindest eine ID und ein Passwort enthalten. Es könnte auch ein CSRF-Token erfordern.
Ausnahmen
TypeError-
Wird geworfen, wenn eine der
id,originoderpasswordOptionen 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.
<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, um es zu verwenden, 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> |