JavaScript метод XMLHttpRequest.getResponseHeader()

Определение и применение

JavaScript метод getResponseHeader() объекта XMLHttpRequest возвращает строку, содержащую текст указанного заголовка, или null, если ответ еще не был получен, или заголовок не существует в ответе.

Обращаю Ваше внимание на то, что если существует несколько заголовков ответов с одинаковым именем, то их значения возвращаются как одна объединенная строка, где каждое значение отделено от предыдущего парой запятых и пробелов. Метод getResponseHeader() возвращает значение в виде последовательности байтов UTF.

Если вам нужно получить необработанную строку всех заголовков, то используйте метод getAllResponseHeaders(), который возвращает все заголовки ответа, разделенные разрывом строки (CRLF) в виде строки.

Обработка cookies выполняется объектом XMLHttpRequest в автоматическом режиме и он исключает заголовки "Cookie" из множества заголовков, возвращаемых методом getAllResponseHeaders(), и возвращает null, если передать аргумент "Set-Cookie" или "Set-Cookie2" методу getResponseHeader(). Заголовки CORS, как и cookie отфильтровываются и не могут быть получены.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
getResponseHeader()	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

const myHeader = XMLHttpRequest.getResponseHeader(headerName);

headerName - String

Cпецификация

Значения параметров

Пример использования

let xhr = new XMLHttpRequest(); // инициализируем переменную новым объектом XMLHttpRequest
xhr.open("GET", "script.php"); // определяем параметры для запроса на определенный адрес
xhr.send(); // отправляем запрос на сервер

xhr.onreadystatechange = function() { // устанавливаем обработчик события
  if(xhr.readyState === 2) { // проверяем состояние запроса
    const contentType = xhr.getResponseHeader("Content-Type"); // возвращаем строку, содержащую текст указанного заголовка
    console.log(contentType); // выводим значение переменной в консоль
  }
}

В этом примере мы инициализируем переменную новым объектом XMLHttpRequest, определяем параметры для "GET" запроса на определенный адрес, и с помощью метода send() отправляем этот запрос. С помощью обработчика onreadystatechange, который срабатывает каждый раз когда изменяется значение свойства readyState, мы проверяем если значение этого свойства соответствует значению 2 (HEADERS_RECEIVED) - метод send() объекта был вызван, заголовки и статус доступны.

После этого с помощью метода getResponseHeader() объекта XMLHttpRequest возвращаем строку, содержащую текст указанного заголовка "Content-Type" (соответствует MIME типу ресурса) и выводим это значение в консоль.