CredentialsContainer.create()
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.
Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La méthode create()
, rattachée à l'interface CredentialsContainer
, renvoie une promesse (Promise
) qui est résolue en
- une nouvelle instance
Credential
construite avec les options fournies null
si aucun objetCredential
ne peut être créé.
Note : Cette méthode ne peut être utilisé que pour les contextes de navigation les plus hauts. Les appels lancés depuis une <iframe>
résoudront la promesse sans aucun effet.
Syntaxe
var promise = CredentialsContainer.create([options]);
Paramètres
options
-
Un objet de type
CredentialCreationOptions
qui contient des options pour le nouvel objetCredentials
demandé. Cet objet doit posséder au moins une des propriétés parmi"password"
,"federated"
ou"publicKey"
. Les options sont :-
password: Facultatif un objet
HTMLFormElement
ou un objetPasswordCredentialData
id
: (obligatoire)USVString
hérité deCredentialData
.name
: FacultatifUSVString
iconURL
: FacultatifUSVString
password
: (required)USVString
-
federated : Facultatif un objet
FederatedCredentialInit
. Cet objet contient le nécessaire pour créer/obtenir des informations d'authentification fédérées. Les propriétés disponibles sont : -
publicKey
: Facultatif un objetPublicKeyCredentialCreationOptions
qui décrit les options pour créer une information d'authentification WebAuthn.
-
Valeur de retour
Une promesse (Promise
) dont la valeur de résolution est une instance Credential
telle que PasswordCredential
, FederatedCredential
ou PublicKeyCredential
.
Spécifications
Specification |
---|
Credential Management Level 1 # dom-credentialscontainer-create |
Compatibilité des navigateurs
BCD tables only load in the browser