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

js
XMLHttpRequest.setRequestHeader(header, value);

Paramètre

Le paramètre du header.

value

La valeur de ce paramètre.

Valeurs de retour

undefined.

Spécifications

Specification
XMLHttpRequest Standard
# the-setrequestheader()-method

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi