XMLHttpRequest.responseText

Черновик
Эта страница не завершена.

Только для чтения 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);

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

 

Спецификация  Статус Comment
XMLHttpRequest Живой стандарт WHATWG living standard

Браузерная совместимость

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
responseTextChrome Полная поддержка ДаEdge Полная поддержка 12Firefox Полная поддержка ДаIE Полная поддержка Да
Замечания
Полная поддержка Да
Замечания
Замечания Before IE 10, the value of XMLHttpRequest.responseText could be read only once the request was complete.
Opera Полная поддержка ДаSafari Полная поддержка 10WebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка ДаOpera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Смотрите замечания реализации.
Смотрите замечания реализации.