XMLHttpRequest

XMLHttpRequest (XHR) オブジェクトを使用すると、サーバーと対話することができます。ページ全体を更新する必要なしに、データを受け取ることができます。これでユーザーの作業を中断させることなく、ウェブページの一部を更新することができます。 XMLHttpRequest は AJAX プログラミングで頻繁に使用されます。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 23.076923076923077%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 650 150" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/XMLHttpRequestEventTarget" target="_top"><rect x="151" y="1" width="250" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="276" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">XMLHttpRequestEventTarget</text></a><polyline points="401,25  411,20  411,30  401,25" stroke="#D4DDE4" fill="none"/><line x1="411" y1="25" x2="441" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/XMLHttpRequest" target="_top"><rect x="441" y="1" width="140" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="511" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">XMLHttpRequest</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

XMLHttpRequest という名前ではあるものの、 XML だけでなくあらゆる種類のデータを受け取るために使用することができ、 HTTP 以外の (file および ftp を含む) プロトコルにも対応しています。

通信においてサーバーからのイベントデータやメッセージデータの受信を含む必要があるのであれば、 Server-sent event の EventSource インターフェイスを使用することも検討してください。全二重の通信では、 WebSocket の方が良いかもしれません。

コンストラクター

XMLHttpRequest()

XMLHttpRequest を初期化するコンストラクターです。これは、他のメソッドを呼び出す前に呼び出さなければなりません。

プロパティ

このインターフェイスは、 XMLHttpRequestEventTarget および EventTarget のプロパティを継承します。

XMLHttpRequest.onreadystatechange

EventHandler で、これは readyState 属性が変化する度に呼び出されます。

XMLHttpRequest.readyState 読取専用

リクエストの状態を unsigned short で返します。

XMLHttpRequest.response 読取専用

リクエストのエンティティ本文を含む ArrayBuffer, Blob, Document, JavaScript オブジェクト, DOMString の何れかを、 XMLHttpRequest.responseType の値に応じて返します。

XMLHttpRequest.responseText 読取専用

リクエストに対するレスポンスがテキスト形式で入った DOMString を返すか、リクエストが失敗した場合や、まだ送信されていない場合は null を返します。

XMLHttpRequest.responseType

レスポンス型を定義する、列挙型の値です。

XMLHttpRequest.responseURL 読取専用

レスポンスのシリアライズされた URL、または URL が null であれば空文字列を返します。

XMLHttpRequest.responseXML 読取専用

リクエストに対するレスポンスが入った Document を返すか、またはリクエストが成功しなかった場合、まだ送信されていない場合、 XML または HTML として解釈できなかった場合は null を返します。

XMLHttpRequest.status 読取専用

リクエストに対するレスポンスのステータスを unsigned short で返します。

XMLHttpRequest.statusText 読取専用

HTTP サーバーから返ってきたレスポンス文字列が入った DOMString を返します。 XMLHTTPRequest.status とは異なり、("200 OK" のように) レスポンスメッセージの完全な文が含まれています。

XMLHttpRequest.timeout

リクエストを自動的に終了できるようになるまでの時間をミリ秒単位で表す、 unsigned long 型の値です。

XMLHttpRequestEventTarget.ontimeout

リクエストがタイムアウトする都度呼び出される EventHandler。

XMLHttpRequest.upload 読取専用

アップロードプロセスを表す XMLHttpRequestUpload です。

XMLHttpRequest.withCredentials

Boolean で、サイト間の Access-Control リクエストでクッキーや認証ヘッダーなどの認証情報を使用するかどうかを示します。

標準外のプロパティ

XMLHttpRequest.channel読取専用

nsIChannel です。リクエストの実行の際にオブジェクトによって使われるチャンネルです。

XMLHttpRequest.mozAnon読取専用

boolean です。 true の場合、リクエストは cookie や認証ヘッダを伴わずに送信します。

XMLHttpRequest.mozSystem読取専用

boolean です。 true の場合、リクエストで同一オリジンポリシーは適用されません。

XMLHttpRequest.mozBackgroundRequest

boolean です。オブジェクトがバックグラウンドサービスのリクエストであるかどうかを示します。

XMLHttpRequest.mozResponseArrayBuffer Gecko 6 で廃止 読取専用

ArrayBuffer です。リクエストに対する、JavaScript typed array 形式でのレスポンスです。

XMLHttpRequest.multipartGecko 22 で廃止

これは Gecko 独自の機能であり、 Firefox/Gecko 22 で削除されました。代わりに Server-Sent Event、Web Socket、または progress イベントの responseText を使用してください。

イベントハンドラー

onreadystatechange は XMLHttpRequest のインスタンスのプロパティとしてすべてのブラウザーが対応しています。

それ以来、数多くの追加のイベントハンドラーが様々なブラウザーに実装されてきています (onload, onerror, onprogress, など)。 XMLHttpRequest の使用を参照してください。

Firefox を含め、より新しいブラウザーでは、 XMLHttpRequest のイベントを on* プロパティをハンドラー関数に設定する方法に加えて、標準の addEventListener() API で待ち受けすることにも対応しています。

メソッド

XMLHttpRequest.abort()

リクエストがすでに送信されている場合、リクエストを中止します。

XMLHttpRequest.getAllResponseHeaders()

CRLF で区切られた文字列として、すべてのレスポンスヘッダを返します。レスポンスを何も受け取らなかった場合は null を返します。

XMLHttpRequest.getResponseHeader()

指定したヘッダ文を含む文字列を返します。レスポンスを受信していない、またはレスポンス中に指定したヘッダが存在しない場合は null を返します。

XMLHttpRequest.open()

リクエストを初期化します。このメソッドは JavaScript から使用するようにしてください。ネイティブコードからの初期化には、代わりに openRequest() を使用するようにしてください。

XMLHttpRequest.overrideMimeType()

サーバーから返ってくる MIME タイプを上書きします。

XMLHttpRequest.send()

リクエストを送信します。非同期リクエスト (既定) の場合、メソッドはリクエストを送信してすぐに返ります。

XMLHttpRequest.setRequestHeader()

HTTP リクエストヘッダーの値を設定します。 setRequestHeader() は open() の後、および send() の前に呼び出さなくてはいけません。

標準外のメソッド

XMLHttpRequest.init()

C++ コードから使用するために、オブジェクトを初期化します。

XMLHttpRequest.openRequest()

リクエストを初期化します。このメソッドはネイティブコードから使用するためのものです。 JavaScript コードからの初期化には、代わりに open() を使用してください。 open() の項目を参照してください。

XMLHttpRequest.sendAsBinary()

バイナリデータを送る、send() メソッドの亜種です。

イベント

abort

例えばプログラムが XMLHttpRequest.abort() を呼び出した時など、リクエストが中断されたときに発生します。
onabort プロパティを通して利用することもできます。

error

リクエストでエラーが発生したときに発生します。
onerror プロパティを通して利用することもできます。

load

XMLHttpRequest のトランザクションが成功裏に完了したときに発生します。
onload プロパティを通して利用することもできます。

loadend

リクエストが完了したときに、成功した場合 (load の後)、成功しなかった場合 (abort または error の後) のどちらでも発生します。
onloadend プロパティを通して利用することもできます。

loadstart

リクエストがデータを読み込み始めたときに発生します。
onloadstart プロパティを通して利用することもできます。

progress

リクエストがもっとデータを受信した際に定期的に発生します。
onprogress プロパティを通して利用することもできます。

仕様書

ブラウザーの対応

関連情報

• XMLSerializer: DOM ツリーの XML へのシリアライズ
• XMLHttpRequest に関連する MDN の記事
  • Ajax — 始めましょう
  • XMLHttpRequest の使用
  • XMLHttpRequest における HTML の扱い
• HTML5 Rocks — New Tricks in XMLHttpRequest2