Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

La méthode setRequestHeader() de l'objet XMLHttpRequest permet d'éditer le header d'une requête HTTP. Vous devez appeler la méthode setRequestHeader(), après la méthode open(), et avant send(). Si vous faite appel plusieurs fois à setRequestHeader() dans une même requête, tout sera combiné au sein d'un même header.

A chaque fois que vous appellez setRequestHeader(), son contenu est ajouté à la fin du header existant.

Si aucun Accept n'a été configurer avec cette méthode, un Accept header avec le type "*/*" sera envoyé avec la requête lorsque send() sera appellée.

Pour des raisons de sécurité, certain header ne peuvent être manipulés que par le user agent. Ceux-ci contiennent les paramètres forbidden header names  et forbidden response header names.

Note: Dans certain cas, vous pourrez rencontrer l'erreur / exception "not allowed by Access-Control-Allow-Headers in preflight response" quand vous enverez une requête cross domains. Dans ce cas, vous devrez configurer Access-Control-Allow-Headers dans votre réponse HTTP coté serveur.

Syntax

XMLHttpRequest.setRequestHeader(header, value)

Paramètre

header
Le paramètre du header.
value
La valeur de ce paramètre.

Valeurs de retour

undefined.

Specifications

Specification Status Comment
XMLHttpRequest
La définition de 'setRequestHeader()' dans cette spécification.
Standard évolutif WHATWG living standard

Compatibilitée avec les navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
setRequestHeaderChrome Support complet 1Edge Support complet 12Firefox Support complet OuiIE Support complet 7
Support complet 7
Support complet 5
Notes
Notes Implemented via ActiveXObject
Opera Support complet OuiSafari Support complet 1.2WebView Android Support complet OuiChrome Android Support complet 18Firefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.

A voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : AkwindFr
Dernière mise à jour par : AkwindFr,