CredentialsContainer: store() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die store()-Methode des CredentialsContainer speichert ein Set von Anmeldeinformationen für den Benutzer in einer Credential-Instanz und gibt diese in einem Promise zurück.
Hinweis:
Diese Methode ist auf oberste Kontexte beschränkt. Aufrufe innerhalb eines <iframe>-Elements werden ohne Wirkung aufgelöst.
Syntax
store(credentials)
Parameter
credentials-
Eine gültige
Credential-Instanz.
Rückgabewert
Ein Promise, das auf undefined aufgelöst wird.
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn es bereits eine Anmeldeinformation des gleichen Typs wie die aktuelle gibt, die in Bearbeitung ist.
Beispiele
Speichern einer Passwort-Anmeldeinformation bei erfolgreicher Authentifizierung
Dieses Codebeispiel wird ausgeführt, nachdem sich ein Benutzer angemeldet oder registriert hat und der Server die Anmeldeinformation als korrekt bestätigt hat.
// Check if the browser supports password credentials (and the Credential Management API)
if ("PasswordCredential" in window) {
let credential = new PasswordCredential({
id: "example-username",
name: "Carina Anand", // In case of a login, the name comes from the server.
password: "correct horse battery staple",
});
navigator.credentials.store(credential).then(
() => {
console.info("Credential stored in the user agent's credential manager.");
},
(err) => {
console.error("Error while storing the credential: ", err);
},
);
}
Spezifikationen
| Spezifikation |
|---|
| Credential Management Level 1 # dom-credentialscontainer-store |