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 プロパティは読み取り専用で、送信されたリクエストに続いてサーバーから受け取ったテキストを返します。

値

文字列で、 XMLHttpRequest を使用して受信したテキストデータ、またはリクエストが失敗したときは null、またはリクエストがまだ send() の呼び出しによって送信されていない場合は "" です。

非同期リクエストを処理している間、 responseText の値は、データが完全に受信できておらず不完全であっても、常にサーバーから受信した現在のコンテンツを持ちます。

readyState の値が XMLHttpRequest.DONE (4) になり、 status の値が 200 ("OK") になった場合、コンテンツ全体が受信されたことが分かります。

例外

InvalidStateError DOMException

XMLHttpRequest.responseType が空文字列または "text" のどちらにも設定されていません。 responseText プロパティはテキストコンテンツのみで有効なので、他の値はエラーの状態です。

例

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);

// If specified, responseType must be empty string or "text"
xhr.responseType = "text";

xhr.onload = () => {
  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