XMLHttpRequest.setRequestHeader()
Метод 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.