Request.credentials

La propriété en lecture seule credentials, de l'interface Request, indique si l'agent utilisateur doit envoyer des cookies de l'autre domaine dans le cas de requêtes CORS. Ceci est similaire au flag withCredentials de XHR, mais peut prendre trois valeurs possibles (contre deux pour XHR) :

  • omit : ne jamais envoyer de cookies.
  • same-origin : envoyer les identifiants utilisateur (cookies, authentification HTTP simple, etc.) si l'URL a la même origine que le script. C'est la valeur par défaut.
  • include : toujours envoyer les identifiants utilisateur (cookies, authentification HTTP simple, etc.) même lorsque l'origine de l'URL est différente.

Syntaxe

var myCred = request.credentials;

Valeur

Une valeur RequestCredentials qui représente les informations d'authentification utilisées pour cette transaction.

Exemples

Dans le morceau de code suivant, on crée une nouvelle requête en utilisant le constructeur Request.Request() (pour un fichier image dans le même dossier que le script), puis on enregistre les identifiants de la requête dans une variable:

var myRequest = new Request('flowers.jpg');
var myCred = myRequest.credentials; // renvoie "same-origin" par défaut

Spécifications

Spécification État Commentaires
Fetch
La définition de 'credentials' dans cette spécification.
Standard évolutif Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
credentials
Expérimentale
Chrome Support complet 42
Support complet 42
Support complet 41
Désactivée
Désactivée From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Support complet 14Firefox Support complet 39
Support complet 39
Support complet 34
Désactivée
Désactivée From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Aucun support NonOpera Support complet 29
Support complet 29
Support complet 28
Désactivée
Désactivée From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Aucun support NonWebView Android Support complet 42Chrome Android Support complet 42Firefox Android Aucun support NonOpera Android Support complet 29
Support complet 29
Support complet 28
Désactivée
Désactivée From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Aucun support NonSamsung Internet Android Support complet 4.0
Default value same-originChrome Support complet 72Edge Support complet 18Firefox Support complet 61IE Aucun support NonOpera Support complet 55Safari Aucun support NonWebView Android Support complet 72Chrome Android Support complet 72Firefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android ?

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.

Voir aussi