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

PasswordCredential

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

Le constructeur PasswordCredential permet de créer un nouvel objet PasswordCredential.

Pour les navigateurs qui prennent en charge cette fonctionnalité, une instance de cette classe peut être utilisée comme propriété credential pour l'objet init qui sera l'argument pour un appel à fetch.

Syntaxe

js
var mesCredentials = new PasswordCredential(passwordCredentialData);
var mesCredentials = new PasswordCredential(HTMLFormElement);

Paramètres

Le constructeur peut prendre l'une de ces deux valeurs en argument.

passwordCredentialData

Un dictionnaire PasswordCredentialData avec les champs suivants :

  • iconURL Facultatif : l'URL de l'image pour l'avatar de l'utilisateur.
  • id : l'identifiant de l'utilisateur qui se connecte.
  • name Facultatif : le nom de l'utilisateur qui se connecte.
  • password : le mot de passe de l'utilisateur qui se connecte.
htmlFormElement

Une référence à un objet HTMLFormElement contenant les champs de saisis appropriés. Le formulaire correspondant devrait contenir au moins un champ id et un champ password. Le formulaire peut aussi demander un jeton CSRF.

Exemples

Dans cet exemple, nous verrons comment définir un formulaire et capturer les données saisies pour créer un objet PasswordCredential.

HTML

html
<form id="form" method="post">
  <input type="text" name="id" autocomplete="username" />
  <input type="password" name="password" autocomplete="current-password" />
  <input type="hidden" name="csrf_token" value="*****" />
</form>

JavaScript

Dans le script, on pourra faire référence à ce formulaire et l'utiliser pour créer un objet PasswordCredential afin de le stocker dans le système de mots de passe de l'agent utilisateur.

js
var form = document.querySelector("#form");
var creds = new PasswordCredential(form);
// Stocker les informations d'authentification
navigator.credentials.store(creds).then(function (creds) {
  // Faire quelque chose avec les informations d'authentification si besoin
});

Spécifications

Specification
Credential Management Level 1
# dom-passwordcredential-passwordcredential
Credential Management Level 1
# dom-passwordcredential-passwordcredential-data

Compatibilité des navigateurs