XMLHttpRequestsend() メソッドは、リクエストをサーバーに送信します。リクエストが非同期の場合(これが既定)、このメソッドはリクエストが送信されるとすぐに戻り、結果はイベントを用いて配信されます。リクエストが同期の場合、このメソッドはレスポンスが到着するまで戻りません。

send() はリクエストの本文を示す引数を一つ受け取ることができます。これは主に PUT のようなリクエストに使用されます。リクエストメソッドが GET 又は HEAD であれば、 body 引数は無視され、リクエストの本文は null に設定されます。

setRequestHeader() を使用して Accept ヘッダーを設定しなかった場合、 Accept ヘッダーは "*/*" 型(任意の型)が送信されます。

構文

XMLHttpRequest.send(body)

引数

body Optional
XHR のリクエストの中で送られる本文データです。次のものが使用できます。 body に値が設定されていない場合、既定値の null が使用されます。

バイナリコンテンツの送信 (例えばファイルのアップロード) の最適な方法は、 ArrayBufferView 又は Blobsend() メソッドを組み合わせることです。

返値

undefined

GET の例

var xhr = new XMLHttpRequest();
xhr.open('GET', '/server', true);

xhr.onload = function () {
  // リクエストの終了。ここの処理を実行します。
};

xhr.send(null);
// xhr.send('string');
// xhr.send(new Blob());
// xhr.send(new Int8Array());
// xhr.send(document);

POST の例

var xhr = new XMLHttpRequest();
xhr.open("POST", '/server', true);

//リクエストに従って正しいヘッダー情報を送信してください
xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");

xhr.onreadystatechange = function() {//状態が変化すると関数が呼び出されます。
    if(xhr.readyState == XMLHttpRequest.DONE && xhr.status == 200) {
        // リクエストの終了。ここの処理を実行します。
    }
}
xhr.send("foo=bar&lorem=ipsum"); 
// xhr.send(new Blob()); 
// xhr.send(new Int8Array()); 
// xhr.send(document);

仕様書

仕様書 状態 備考
XMLHttpRequest
send() の定義
現行の標準 WHATWG living standard

ブラウザーの対応

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応1121

7

51

あり1.2
ArrayBuffer as parameter to send()9 あり91011.6 あり
ArrayBufferView as parameter to send()22 ?20 ? あり ?
Blob as parameter to send()22 あり21012 ?
FormData as parameter to send()6 あり21012 ?
URLSearchParams as parameter to send()59 ?44 ?12 ?
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応 あり1 あり4 あり あり あり
ArrayBuffer as parameter to send() あり あり ?9 あり ? あり
ArrayBufferView as parameter to send() あり あり ?20 あり ? あり
Blob as parameter to send() あり あり ?4 あり ? あり
FormData as parameter to send() あり あり ?4 あり ? あり
URLSearchParams as parameter to send() あり59 ?44 あり ?7.0

1. Implemented via ActiveXObject

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, laripappa
最終更新者: mfuji09,