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 Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 5
Замечания
Полная поддержка 5
Замечания
Замечания Before Internet Explorer 10, the value of XMLHttpRequest.responseText could be read only once the request was complete.
Opera Полная поддержка 8Safari Полная поддержка 1.2WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка 1.0

Легенда

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