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 предназначено только для текстового содержимого, любое другое значение вызовет ошибку.

Пример

js
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