JavaScript свойство XMLHttpRequest.responseText
Определение и применение
JavaScript свойство responseText объекта
XMLHttpRequest
возвращает строковое значение, содержащее ответ на запрос в виде текста, или пустую строку, если текст ответа ещё
недоступен или произошла сетевая ошибка.
Поддержка браузерами
Спецификация: xhr.spec.whatwg
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
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;
Спецификация
Исключения
| Тип исключения | Описание |
|---|---|
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(); // отправляем запрос на сервер