1. Web
  2. Les API Web
  3. CredentialsContainer
  4. CredentialsContainer.get()

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

CredentialsContainer.get()

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨septembre 2019⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode get(), rattachée à l'interface CredentialsContainer, renvoie une promesse (Promise) qui est résolue en une instance de Credential correspondant aux paramètres fournis. Si aucune correspondance n'est trouvée, la promesse sera résolue avec la valeur null.

Cette méthode collecte l'ensemble des informations d'authentification stockées dans l'objet CredentialsContainer et qui respectent les critères indiqués (définis grâce à l'argument options). À partir de cet ensemble, l'agent utilisateur sélectionne la meilleure information d'authentification. Selon les options fournies, l'agent utilisateur pourra afficher une boîte de dialogue et demander à l'utilisateur de sélectionner la bonne information.

Cette méthode récupère les informations d'authentification en appelant la méthode CollectFromCredentialStore pour chaque type d'authentification permis par l'argument options. Ainsi, si la propriété options.password existe dans l'argument passé, PasswordCredential.[[CollectFromCredentialStore]] sera appelée.

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

js
var promise = CredentialsContainer.get([options]);

Paramètres

options Facultatif

Un objet de type CredentialRequestOptions qui contient les critères de la requête. et les options d'interaction avec l'utilisateur. Cet objet peut contenir les propriétés suivantes :

  • password : un booléen (Boolean) qui indique que l'instance Credential renvoyée devrait contenir les informations sur l'utilisateur (contrairement aux informations d'authentification fédérées).

  • federated : un objet FederatedCredentialRequestOptions qui contient les critères que doivent respecter les informations d'authentification fédérées. Les options disponibles sont :

    • providers : un tableau de chaînes de caractères DOMString listant les fournisseurs d'identité potentiels
    • protocols : un tableau de chaînes de caractères DOMString listant les protocoles de fédération à rechercher.

  • publicKey : un objet PublicKeyCredentialRequestOptions contenant les conditions que doivent respecter les informations d'authentification WebAuthn qui seront renvoyées.

  • mediation : une chaîne de caractères String qui indique si l'utilisateur devra se reconnecter à chaque visite sur le site. Les valeurs valides sont "silent", "optional" ou "required".

  • unmediated : un booléen (Boolean) qui indique que l'instance Credential renvoyée ne devrait pas nécessiter de médiation avec l'utilisateur.

Valeur de retour

Une promesse (Promise) qui est résolue avec une instance Credential correspondant aux paramètres fournis. S'il n'est pas possible d'obtenir une seule instance sans ambiguïté, la promesse sera résolue avec la valeur null.

Spécifications

Specification
Credential Management Level 1
# dom-credentialscontainer-get

Compatibilité des navigateurs

Help improve MDN

Learn how to contribute

Cette page a été modifiée le par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content