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.

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

BCD tables only load in the browser

A voir aussi