XMLHttpRequest.setRequestHeader()
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
(en-US) dans votre réponse HTTP coté serveur.
Syntaxe
js
XMLHttpRequest.setRequestHeader(header, value);
Paramètre
Valeurs de retour
undefined
.
Spécifications
Specification |
---|
XMLHttpRequest Standard # the-setrequestheader()-method |
Compatibilité des navigateurs
BCD tables only load in the browser