Request.credentials
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
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
Specification |
---|
Fetch Standard # ref-for-dom-request-credentials② |
Compatibilité des navigateurs
BCD tables only load in the browser