XMLHttpRequest: метод getResponseHeader()
Базовая Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Примечание: Эта функция доступна в Потоках выполнения, за исключением Рабочих потоков.
Метод XMLHttpRequest getResponseHeader() возвращает строку, содержащую текст значения определенного заголовка.
Если существует несколько заголовков ответа с одинаковым именем, их значения возвращаются как одна конкатенированная строка, где каждое значение отделено от предыдущего парой запятая и пробел. Метод getResponseHeader() возвращает значение в виде последовательности байтов UTF.
Примечание: Поиск имени заголовка выполняется без учета регистра.
Если вам нужно получить исходную строку всех заголовков, используйте метод getAllResponseHeaders(), который возвращает всю исходную строку заголовков.
Синтаксис
getResponseHeader(headerName)
Параметры
headerName-
Строка, указывающая имя заголовка, для которого нужно вернуть текстовое значение.
Возвращаемое значение
Строка, представляющая текстовое значение заголовка, или null , если ответ ещё не получен или заголовок не существует в ответе.
Примеры
В этом примере создается и отправляется запрос, и устанавливается обработчик события readystatechange для поиска состояния readyState, указывающего, что заголовки получены; в этом случае извлекается значение заголовка Content-Type. Если Content-Type не является нужным значением, запрос XMLHttpRequest отменяется вызовом abort().
const client = new XMLHttpRequest();
client.open("GET", "unicorns-are-awesome.txt", true);
client.send();
client.onreadystatechange = () => {
if (client.readyState === client.HEADERS_RECEIVED) {
const contentType = client.getResponseHeader("Content-Type");
if (contentType !== my_expected_type) {
client.abort();
}
}
};
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getResponseHeader |
1 | 12 | 1Начиная с Firefox 49, пустые заголовки возвращаются как пустые строки в случае, если предпочтительное значениеnetwork.http.keep_empty_response_headers_as_empty_string установлено как true, по умолчанию false. Перед Firefox 49 пустые заголовки игнорировались. Начиная с Firefox 50, предпочтительное значение по умолчанию true. |
8 | 1.2 | 18 | 4Начиная с Firefox для Android 49, пустые заголовки возвращаются как пустые строки в случае, если предпочтительное значениеnetwork.http.keep_empty_response_headers_as_empty_string установлено как true, по умолчанию false. Перед Firefox для Android 49 пустые заголовки игнорировались. Начиная с Firefox для Android 50, предпочтительное значение по умолчанию true. |
10.1 | 1 | 1.0 | 4.4 |
См. также
- Использование XMLHttpRequest
- HTTP-заголовки
getAllResponseHeaders()response- Установка заголовков запроса:
setRequestHeader()
© 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/getResponseHeader