Spec-Zone.ru › Web APIs

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();
    }
  }
};

Спецификации

Спецификация
XMLHttpRequest
# dom-xmlhttprequest-getresponseheader

Совместимость с браузерами

Рабочие столы Мобильные устройства
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API