XMLHttpRequest.responseText
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Только для чтения XMLHttpRequest
свойство responseText
возвращает текст ответа от сервера на отправленный запрос.
Syntax
var resultText = XMLHttpRequest.responseText;
Значение
Строка DOMString
содержащая либо текстовые данные, полученные при использовании XMLHttpRequest
, либо null
в случае, когда вопрос возвратил ошибку, или же ещё не был отослан на сервер вызовом функции send()
.
Во время выполнения асинхронных запросов, в значении responseText
всегда находится текущее содержимое, полученное от сервера, даже если запрос ещё не завершён, и данные от сервера не получены полностью.
Понять, что ответ получен полностью, можно когда значение readyState
становится XMLHttpRequest.DONE
(4
), а значение status
становится 200 ("OK"
).
Исключения
InvalidStateError
-
Возникает, когда значению
XMLHttpRequest.responseType
не присвоена либо пустая строка, либо "text". Поскольку свойствоresponseText
предназначено только для текстового содержимого, любое другое значение вызовет ошибку.
Пример
var xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);
// responseType должно быть пустой строкой, либо "text"
xhr.responseType = "text";
xhr.onload = function () {
if (xhr.readyState === xhr.DONE) {
if (xhr.status === 200) {
console.log(xhr.response);
console.log(xhr.responseText);
}
}
};
xhr.send(null);
Спецификации
Specification |
---|
XMLHttpRequest Standard # the-responsetext-attribute |
Совместимость с браузерами
BCD tables only load in the browser