Request.mode

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété mode (en lecture seule) de l’interface Request contient le mode de la requête (e.g., cors, no-cors, cors-with-forced-preflight, same-origin, or navigate.) Ceci est utilisé pour déterminer si les requêtes différentes de l’origine (cross-origin) mèneront à des réponses valides, et quelles propriétés de la réponse seront lisibles:

  • same-origin — Avec ce mode défini, si la requête est faite vers une autre origine, le résultat sera une erreur. Vous pouvez utiliser ceci afin de vous assurer que la requête sera toujours faites vers votre origine.
  • no-cors — Prévient la méthode d’une utilisation autre que HEAD, GET ou POST. Si un ServiceWorkers interceptait ces requêtes, il ne pourrait pas ajouter ou réécrire ces en-têtes excepté pour ceci. De plus, JavaScript ne peut accéder à aucune propriété de la Response. Cela vous assure que les ServiceWorkers n’affecteront pas la sémantique du Web et prévient pour des raisons de sécurité et de confidentialité pouvant mener à la fuite de données à travers les domaines.
  • cors — Permet les requêtes cross-origin pour, par exemple, accéder à diverses APIs fournies par de tierces parties. Ces derniers sont censés adhérer au protocole CORS. Seul un jeu limité d’en-têtes est exposé dans la Response, mais le corps (body) est lisible.
  • navigate — Un mode pour supporter la navigation. La valeur navigate est destinée à être utilisée seulement par la navigation HTML. Une requête navigate est créée seulement lorsqu’on navigue entre des documents.

Syntaxe

var myMode = request.mode;

Valeur

Une valeur RequestMode.

Exemple

Dans le bout de code suivant, nous créons une nouvelle requête en utilisant le constructeur Request.Request()  (pour une image située dans le même répertoire que le script), puis on stocke le mode de la requête dans une variable:

var myRequest = new Request('flowers.jpg');
var myMode = myRequest.mode; // returns "cors" by default

Spécifications

Spécification État Commentaires
Fetch
La définition de 'mode' 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
mode
Expérimentale
Chrome Support complet 42Edge Support complet 14Firefox Support complet 39IE Aucun support NonOpera Support complet 29Safari Support complet 10.1WebView Android Support complet 49Chrome Android Support complet 49Firefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Support complet 10.3Samsung Internet Android Support complet 5.0
navigate mode
Expérimentale
Chrome Support complet 49Edge Support complet ≤18Firefox Support complet 46IE Aucun support NonOpera ? Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 49Firefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Support complet 10.3Samsung Internet Android Support complet 5.0

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.

Voir aussi