Метод XMLHttpRequest.setRequestHeader() устанавливает значения HTTP заголовков. Метод setRequestHeader() следует вызывать только после open(), но до send(). Если метод вызывается несколько раз подряд, значения присоединяется к одному и тому же заголовку.
Если заголовок Accept не был установлен, то он будет передан в запросе со значением */* когда будет вызван метод send().
В целях безопасности, некоторые заголовки не могут быть установлены программно. Для более подробной информации, смотрите forbidden header names и forbidden response header names.
Для ваших собственных полей, вы можете увидеть исключение "not allowed by Access-Control-Allow-Headers in preflight response", когда вы делаете кросс-доменный запрос. В этом случае, вам нужно установить заголовок "Access-Control-Allow-Headers" в ответе на стороне сервера.
Синтаксис
XMLHttpRequest.setRequestHeader(header, value)
Параметры
header- Имя устанавливаемого заголовка
value- Значение, которое будет установлено как тело заголовка
Спецификации
| Спецификация | Статус | Комментарий |
|---|---|---|
| XMLHttpRequest Определение 'setRequestHeader()' в этой спецификации. |
Живой стандарт | WHATWG living standard |
Совместимость браузеров
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | 1 | (Да) | ? | 5[1] 7 |
(Да) | 1.2 |
| Feature | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | ? | 1.0 | (Да) | (Да) | ? | ? | ? |
[1] Эта особенность была реализована через ActiveXObject(). Internet Explorer реализует стандарт XMLHttpRequest начиная с версии 7.