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

js
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:

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

Spécifications

Specification
Fetch
# ref-for-dom-request-credentials②

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
credentials
Default value same-origin

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Voir aussi