XMLHttpRequest: метод setRequestHeader()
Базовая поддержка Широко распространена
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Примечание: Эта функция доступна в Web Workers, за исключением Service Workers.
Метод XMLHttpRequest setRequestHeader() устанавливает значение заголовка HTTP-запроса. При использовании setRequestHeader(), вы должны вызвать его после вызова open(), но перед вызовом send(). Если этот метод вызывается несколько раз с одним и тем же заголовком, значения объединяются в один заголовок запроса.
Каждый раз, когда вы вызываете setRequestHeader() после первого вызова, указанный текст добавляется в конец существующего содержимого заголовка.
Если не был установлен заголовок Accept, при вызове send() отправляется заголовок Accept с типом "*/*".
По соображениям безопасности существует несколько запрещённых имён заголовков, значения которых контролируются пользовательским агентом. Любая попытка установить значение одного из таких заголовков из кода frontend JavaScript будет проигнорирована без предупреждения или ошибки.
Кроме того, заголовок HTTP Authorization может быть добавлен к запросу, но будет удалён, если запрос перенаправлен на другой домен.
Примечание: При работе с пользовательскими полями вы можете столкнуться с исключением «не разрешено Access-Control-Allow-Headers в ответе на предварительный запрос» при отправке запросов между доменами. В этом случае вам необходимо настроить заголовок Access-Control-Allow-Headers в заголовке ответа на стороне сервера.
Синтаксис
setRequestHeader(header, value)
Параметры
Возвращаемое значение
Ничего (undefined).
Спецификации
| Спецификация |
|---|
| XMLHttpRequest # the-setrequestheader()-method |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari в iOS | Samsung Internet | WebView Android | |
setRequestHeader |
1 | 12 | 1 | 8 | 1.2 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 |
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/setRequestHeader
