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 les Web Workers.
La propriété en lecture seule credentials de l'interface Request reflète la valeur donnée au constructeur Request() dans l'option credentials. 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éponse Set-Cookie sont pris en compte.
Les informations d'identification sont des cookies, des certificats client TLS, ou des en-têtes d'authentification contenant un nom d'utilisateur et un mot de passe.
Voir Inclure les informations d'identification pour plus de détails.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
omit-
N'envoie jamais d'informations d'identification dans la requête et n'inclut jamais d'informations d'identification dans la réponse.
same-origin-
N'envoie et n'inclut les informations d'identification que pour les requêtes de même origine. C'est la valeur par défaut.
include-
Inclut 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 constructeur Request() (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éfaut
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-request-credentials② |
Compatibilité des navigateurs
Voir aussi
- L'API ServiceWorker
- Contrôle d'accès HTTP (CORS)
- La référence HTTP