JavaScript свойство XMLHttpRequest.responseText

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

JavaScript свойство responseText объекта XMLHttpRequest возвращает строковое значение, содержащее ответ на запрос в виде текста, или пустую строку, если текст ответа ещё недоступен или произошла сетевая ошибка.

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

Спецификация: xhr.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьapi.XMLHttpRequest.responseText
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
responseText✓1✓12✓1✓8✓1.2✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
let resultText = xhr.responseText;

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

XMLHttpRequest Standard.

Исключения

Тип исключения Описание — XMLHttpRequest.responseText
Тип исключения Описание
InvalidStateError Возникает в том случае, если значение свойства responseType не соответствует пустой строке, или значению "text". Поскольку свойство responseText допустимо только для текстового содержимого, любое другое значение вызовет ошибку.

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

Пример ниже демонстрирует получение строкового значения от сервера, содержащее ответ на запрос в виде текста:

JavaScript
let xhr = new XMLHttpRequest(); // инициализируем только что созданный запрос
xhr.open("GET", "/info"); // определяем параметры для запроса
xhr.responseType = "text"; // указываем тип данных, ожидаемых в ответе
xhr.onreadystatechange = function() { // добавляем обработчик события
   // проверяем состояние запроса и числовой код состояния HTTP ответа
   if (xhr.readyState === 4 && xhr.status === 200) {
     const resultText = xhr.responseText; // строковое значение, содержащее ответ на запрос в виде текста
     console.log(resultText); // выводим в консоль это значение
   }
};
xhr.send(); // отправляем запрос на сервер