XMLHttpRequest

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

メモ: この機能はウェブワーカー内で利用可能ですが、サービスワーカーでは使用できません。

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

XMLHttpRequest という名前ではあるものの、 XML だけでなく、あらゆる種類のデータを受け取るために使用することができます。

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

コンストラクター

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

インスタンスプロパティ

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

XMLHttpRequest.readyState読取専用: リクエストの状態を表す数値を返します。
XMLHttpRequest.response読取専用: ArrayBuffer、Blob、Document、JavaScript オブジェクト、文字列の何れか（XMLHttpRequest.responseType の値による）で、リクエストのエンティティ本体を返します。
XMLHttpRequest.responseText読取専用: 文字列で、リクエストに対するレスポンスをテキスト形式で返すか、リクエストが失敗した場合や、まだ送信されていない場合はnull を返します。
XMLHttpRequest.responseType: レスポンスの種類を示します。
XMLHttpRequest.responseURL読取専用: レスポンスのシリアライズされた URL、または URL が null であれば空文字列を返します。
XMLHttpRequest.responseXML読取専用: Document でリクエストに対するレスポンスが入ったを返すか、またはリクエストが成功しなかった場合、まだ送信されていない場合、 XML または HTML として解釈できなかった場合はnull を返します。ウェブワーカーでは利用できません。
XMLHttpRequest.status読取専用: リクエストのHTTP レスポンスステータスコードを返します。
XMLHttpRequest.statusText読取専用: 文字列で、HTTP サーバーから返ってきたレスポンス文字列を返します。XMLHttpRequest.status とは異なり、（"OK" のような）レスポンスメッセージの完全な文が含まれています。
メモ:HTTP/2 仕様書RFC 7540, セクション 8.1.2.4: Response Pseudo-Header Fields によれば、 HTTP/2 では、 HTTP/1.1 のステータス行に含まれていたバージョンや原因の文を伝える方法が定義されていません。
XMLHttpRequest.timeout: リクエストを自動的に終了するまでの時間をミリ秒単位で表します。
XMLHttpRequest.upload読取専用: XMLHttpRequestUpload で、アップロードプロセスを表します。
XMLHttpRequest.withCredentials: サイト間のAccess-Control リクエストでクッキーや認証ヘッダーなどの資格情報を使用する場合はtrue を返します。そうでなければfalse を返します。

標準外のプロパティ

XMLHttpRequest.mozAnon読取専用非標準: 論理値です。 true の場合、リクエストを Cookie や認証ヘッダーを伴わずに送信します。
XMLHttpRequest.mozSystem読取専用非標準: 論理値です。 true の場合、リクエストで同一オリジンポリシーは適用されません。

インスタンスメソッド

XMLHttpRequest.abort(): リクエストがすでに送信されている場合、リクエストを中止します。
XMLHttpRequest.getAllResponseHeaders(): すべてのレスポンスヘッダーを、CRLF で区切り、文字列として返します。レスポンスを何も受け取らなかった場合はnull を返します。
XMLHttpRequest.getResponseHeader(): 指定したヘッダーを含む文字列を返します。レスポンスを受信していない、またはレスポンス内に指定したヘッダーが存在しない場合はnull を返します。
XMLHttpRequest.open(): リクエストを初期化します。
XMLHttpRequest.overrideMimeType(): サーバーから返ってくる MIME タイプを上書きします。
XMLHttpRequest.send(): リクエストを送信します。このリクエストが非同期（既定）の場合、このメソッドはリクエストが送るとすぐに返ります。
XMLHttpRequest.setAttributionReporting()安全なコンテキスト用Experimental: リクエストのレスポンスで、帰属ソースや発生するイベントを登録できるようにすることを示します。
XMLHttpRequest.setRequestHeader(): HTTP リクエストヘッダーの値を設定します。setRequestHeader() はopen() の後、およびsend() の前に呼び出さなくてはいけません。