XMLHttpRequest : propriété withCredentials
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers, sauf pour les Service Workers.
La propriété withCredentials de l'interface XMLHttpRequest est une valeur booléenne qui indique si les requêtes Access-Control inter-sites doivent être effectuées en utilisant des informations d'identification telles que des cookies, des en-têtes d'authentification ou des certificats client TLS. La définition de withCredentials n'a aucun effet sur les requêtes de même origine.
De plus, ce drapeau est également utilisé pour indiquer quand les cookies doivent être ignorés dans la réponse. La valeur par défaut est false. Les réponses XMLHttpRequest provenant d'un domaine différent ne peuvent pas définir de valeurs de cookie pour leur propre domaine à moins que withCredentials ne soit défini sur true avant d'effectuer la requête. Les cookies tiers obtenus en définissant withCredentials sur true respectent toujours la politique de même origine et ne peuvent donc pas être accessibles par le script demandeur avec Document.cookie ou à partir des en-têtes de réponse.
Note : Cela n'affecte jamais les requêtes de même origine.
Note :
Les réponses XMLHttpRequest provenant d'un domaine différent ne peuvent pas définir de valeurs de cookie pour leur propre domaine à moins que withCredentials ne soit défini sur true avant d'effectuer la requête, indépendamment des valeurs des en-têtes Access-Control-.
Exemples
const xhr = new XMLHttpRequest();
xhr.open("GET", "http://example.com/", true);
xhr.withCredentials = true;
xhr.send(null);
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-withcredentials-attribute |