[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/XMLHttpRequest/withCredentials [Back]  [Original]

XMLHttpRequest.withCredentials - Les API Web | MDN

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

XMLHttpRequest.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.

La proprit XMLHttpRequest.withCredentials est un boolen qui indique si une requte Access-Control entre plusieurs sites devrait tre ralise avec des informations d'authentification (credentials) telles que des cookies, des en-ttes d'autorisation ou des certificats clients. Activer withCredentials n'aura aucun impact sur les requtes effectues sur un mme site.

Cette proprit est galement utilise afin d'indiquer lorsque les cookies doivent tre ignors pour une rponse. Par dfaut, la valeur est false. Une requte XMLHttpRequest d'un autre domaine ne pourra pas dfinir de cookies pour cet autre domaine moins que withCredentials vaille true avant la requte.

Les cookies tiers obtenus lorsque withCredentials vaut true continuent de respecter la rgle de mme origine et ne peuvent donc pas tre manipuls en script via document.cookie ou depuis les en-ttes de la rponse.

Note : Cette proprit n'a aucun impact pour les requtes effectues sur le mme site.

Note : Les rponses XMLHttpRequest provenant d'un domaine diffrent ne peuvent pas dfinir de cookies pour ce domaine moins d'avoir withCredentials true avant l'envoi de la requte (quelle que soit la valeur de l'en-tte Access-Control-).

Dans cet article

Exemples

js
var xhr = new XMLHttpRequest();
xhr.open("GET", "http://example.com/", true);
xhr.withCredentials = true;
xhr.send(null);

Spcifications

Spcification
XMLHttpRequest
# the-withcredentials-attribute

Compatibilit des navigateurs


Web Proxy Viewer  |  New URL  |  Original Page