CredentialsContainer: store() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
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
NotAllowedError
DOMException
-
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
Specification |
---|
Credential Management Level 1 # dom-credentialscontainer-store |
Browser-Kompatibilität
BCD tables only load in the browser