XMLHttpRequest.setRequestHeader()

Cette traduction est incomplète. Aidez-nous à 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 1IE Support complet 5Opera Support complet 8Safari Support complet 1.2WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet

A voir aussi