Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Request : propriété credentials
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 mars 2017.
Note : Cette fonctionnalité est disponible via lesWeb Workers.
La propriété en lecture seulecredentials de l'interfaceRequest reflète la valeur donnée au constructeurRequest() dans l'optioncredentials. Elle détermine si le navigateur envoie ou non des informations d'identification avec la requête, ainsi que si les en-têtes de réponseSet-Cookie sont pris en compte.
Les informations d'identification sont des cookies, des certificats clientTLS, ou des en-têtes d'authentification contenant un nom d'utilisateur et un mot de passe.
VoirInclure les informations d'identification pour plus de détails.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
omitN'envoie jamais d'informations d'identification dans la requête et n'inclut jamais d'informations d'identification dans la réponse.
same-originN'envoie et n'inclut les informations d'identification que pour les requêtes de même origine.C'est la valeur par défaut.
includeInclut toujours les informations d'identification, même pour les requêtes inter-origines.
Exemples
Dans l'extrait de code suivant, nous créons une nouvelle requête à l'aide du constructeurRequest() (pour un fichier image dans le même répertoire que le script), puis nous enregistrons les identifiants de la requête dans une variable :
const requete = new Request("fleurs.jpg");const identifiants = requete.credentials; // retourne "same-origin" par défautSpécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-credentials② |