XMLHttpRequest.setRequestHeader()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
Syntaxe
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