From 76ad2def9076400c5c55d43aa1f58e6a291791d3 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 29 Jan 2022 22:55:27 +0900 Subject: XMLHttpRequest のメソッドを移行 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/xmlhttprequest/abort/index.html | 76 ------------ files/ja/web/api/xmlhttprequest/abort/index.md | 76 ++++++++++++ .../getallresponseheaders/index.html | 121 ------------------- .../xmlhttprequest/getallresponseheaders/index.md | 121 +++++++++++++++++++ .../xmlhttprequest/getresponseheader/index.html | 90 -------------- .../api/xmlhttprequest/getresponseheader/index.md | 90 ++++++++++++++ files/ja/web/api/xmlhttprequest/open/index.html | 71 ----------- files/ja/web/api/xmlhttprequest/open/index.md | 71 +++++++++++ files/ja/web/api/xmlhttprequest/send/index.html | 131 --------------------- files/ja/web/api/xmlhttprequest/send/index.md | 131 +++++++++++++++++++++ .../api/xmlhttprequest/setrequestheader/index.html | 80 ------------- .../api/xmlhttprequest/setrequestheader/index.md | 80 +++++++++++++ 12 files changed, 569 insertions(+), 569 deletions(-) delete mode 100644 files/ja/web/api/xmlhttprequest/abort/index.html create mode 100644 files/ja/web/api/xmlhttprequest/abort/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/getallresponseheaders/index.html create mode 100644 files/ja/web/api/xmlhttprequest/getallresponseheaders/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/getresponseheader/index.html create mode 100644 files/ja/web/api/xmlhttprequest/getresponseheader/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/open/index.html create mode 100644 files/ja/web/api/xmlhttprequest/open/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/send/index.html create mode 100644 files/ja/web/api/xmlhttprequest/send/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/setrequestheader/index.html create mode 100644 files/ja/web/api/xmlhttprequest/setrequestheader/index.md (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/xmlhttprequest/abort/index.html b/files/ja/web/api/xmlhttprequest/abort/index.html deleted file mode 100644 index 7c33a0a30e..0000000000 --- a/files/ja/web/api/xmlhttprequest/abort/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: XMLHttpRequest.abort() -slug: Web/API/XMLHttpRequest/abort -tags: - - AJAX - - API - - HTTP - - HttpRequest - - XMLHttpRequest - - abort - - cancel - - メソッド - - リファレンス - - 停止 -translation_of: Web/API/XMLHttpRequest/abort ---- -
{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.abort() メソッドは、すでに送信された要求を中止します。要求が中止されたら、 {{domxref("XMLHttpRequest.readyState", "readyState")}} が {{domxref("XMLHttpRequest.UNSENT")}} (0) に変化し、要求の {{domxref("XMLHttpRequest.status", "status")}} コードが0に設定されます。

- -

構文

- -
XMLHttpRequest.abort()
- -

引数

- -

なし。

- -

返値

- -

undefined

- -

例

- -

この例では、 MDN のホームページからコンテンツを読み込み始め、ある条件が発生したときに、 abort() を呼び出すことで転送を中止します。

- -
var xhr = new XMLHttpRequest(),
-    method = "GET",
-    url = "https://developer.mozilla.org/";
-xhr.open(method, url, true);
-
-xhr.send();
-
-if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
-  xhr.abort();
-}
-
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-abort()-method')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの対応

- -

{{Compat("api.XMLHttpRequest.abort")}}

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/abort/index.md b/files/ja/web/api/xmlhttprequest/abort/index.md new file mode 100644 index 0000000000..7c33a0a30e --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/abort/index.md @@ -0,0 +1,76 @@ +--- +title: XMLHttpRequest.abort() +slug: Web/API/XMLHttpRequest/abort +tags: + - AJAX + - API + - HTTP + - HttpRequest + - XMLHttpRequest + - abort + - cancel + - メソッド + - リファレンス + - 停止 +translation_of: Web/API/XMLHttpRequest/abort +--- +
{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.abort() メソッドは、すでに送信された要求を中止します。要求が中止されたら、 {{domxref("XMLHttpRequest.readyState", "readyState")}} が {{domxref("XMLHttpRequest.UNSENT")}} (0) に変化し、要求の {{domxref("XMLHttpRequest.status", "status")}} コードが0に設定されます。

+ +

構文

+ +
XMLHttpRequest.abort()
+ +

引数

+ +

なし。

+ +

返値

+ +

undefined

+ +

例

+ +

この例では、 MDN のホームページからコンテンツを読み込み始め、ある条件が発生したときに、 abort() を呼び出すことで転送を中止します。

+ +
var xhr = new XMLHttpRequest(),
+    method = "GET",
+    url = "https://developer.mozilla.org/";
+xhr.open(method, url, true);
+
+xhr.send();
+
+if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
+  xhr.abort();
+}
+
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-abort()-method')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの対応

+ +

{{Compat("api.XMLHttpRequest.abort")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.html b/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.html deleted file mode 100644 index 161f49be5f..0000000000 --- a/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: XMLHttpRequest.getAllResponseHeaders() -slug: Web/API/XMLHttpRequest/getAllResponseHeaders -tags: - - API - - Fetch Headers - - Get Headers - - HTTP - - HTTP Header - - Method - - Reference - - Response Header - - XHR - - XMLHttpRequest - - getAllResponseHeaders -translation_of: Web/API/XMLHttpRequest/getAllResponseHeaders ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の getAllResponseHeaders() メソッドは、すべてのレスポンスヘッダーを {{Glossary('CRLF')}} で区切った文字列として返し、レスポンスを受信していない場合は null を返します。ネットワークエラーが発生した場合は、空文字列が返されます。

- -
-

注: マルチパートリクエストでは、これはリクエストの元のチャンネルではなく、現在の部分を返します。

-
- -

構文

- -
var headers = XMLHttpRequest.getAllResponseHeaders();
- -

引数

- -

なし。

- -

返値

- -

{{Glossary('CRLF')}} で区切ったすべてのレスポンスヘッダー (フィールド名が Set-Cookie または Set-Cookie2 のものを除く) を表す {{domxref("ByteString")}}、またはレスポンスを受信していなければ null です。ネットワークエラーが発生した場合は、空文字列が返されます。

- -

生のヘッダー文字列がどのように見えるかの例です。

- -
date: Fri, 08 Dec 2017 21:04:30 GMT\r\n
-content-encoding: gzip\r\n
-x-content-type-options: nosniff\r\n
-server: meinheld/0.6.1\r\n
-x-frame-options: DENY\r\n
-content-type: text/html; charset=utf-8\r\n
-connection: keep-alive\r\n
-strict-transport-security: max-age=63072000\r\n
-vary: Cookie, Accept-Encoding\r\n
-content-length: 6502\r\n
-x-xss-protection: 1; mode=block\r\n
- -

各行はキャリッジリターンとラインフィード文字 (\r\n) の両方で終わります。これらはそれぞれのヘッダーを区切る基本的なデリミターです。

- -
-

注: 最近のブラウザーでは、ヘッダー名は最新の仕様書にあるように、すべて小文字で返されます。

-
- -

例

- -

この例では、リクエストの {{event("readystatechange")}} イベントハンドラーである {{domxref("XMLHttpRequest.onreadystatechange")}} の中でヘッダーを調べます。このコードは生のヘッダー文字列を取得する方法、またそれを個別のヘッダーの配列に変換する方法、そして配列からヘッダー名とその値のマップを生成する方法を示しています。

- -
var request = new XMLHttpRequest();
-request.open("GET", "foo.txt", true);
-request.send();
-
-request.onreadystatechange = function() {
-  if(this.readyState == this.HEADERS_RECEIVED) {
-
-    // 生のヘッダー文字列を取得
-    var headers = request.getAllResponseHeaders();
-
-    // ヘッダー文字列を個別のヘッダーの
-    // 配列に変換
-    var arr = headers.trim().split(/[\r\n]+/);
-
-    // ヘッダー名と値のマップを生成
-    var headerMap = {};
-    arr.forEach(function (line) {
-      var parts = line.split(': ');
-      var header = parts.shift();
-      var value = parts.join(': ');
-      headerMap[header] = value;
-    });
-  }
-}
- -

いったんこれを行えば、次のようなことができます。

- -
var contentType = headerMap["content-type"];
- -

これは {{httpheader("Content-Type")}} ヘッダーの値を変数 contentType の中に入れます。

- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-getallresponseheaders()-method', 'getAllResponseHeaders()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの互換性

- -
{{Compat("api.XMLHttpRequest.getAllResponseHeaders")}}
- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.md b/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.md new file mode 100644 index 0000000000..161f49be5f --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/getallresponseheaders/index.md @@ -0,0 +1,121 @@ +--- +title: XMLHttpRequest.getAllResponseHeaders() +slug: Web/API/XMLHttpRequest/getAllResponseHeaders +tags: + - API + - Fetch Headers + - Get Headers + - HTTP + - HTTP Header + - Method + - Reference + - Response Header + - XHR + - XMLHttpRequest + - getAllResponseHeaders +translation_of: Web/API/XMLHttpRequest/getAllResponseHeaders +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の getAllResponseHeaders() メソッドは、すべてのレスポンスヘッダーを {{Glossary('CRLF')}} で区切った文字列として返し、レスポンスを受信していない場合は null を返します。ネットワークエラーが発生した場合は、空文字列が返されます。

+ +
+

注: マルチパートリクエストでは、これはリクエストの元のチャンネルではなく、現在の部分を返します。

+
+ +

構文

+ +
var headers = XMLHttpRequest.getAllResponseHeaders();
+ +

引数

+ +

なし。

+ +

返値

+ +

{{Glossary('CRLF')}} で区切ったすべてのレスポンスヘッダー (フィールド名が Set-Cookie または Set-Cookie2 のものを除く) を表す {{domxref("ByteString")}}、またはレスポンスを受信していなければ null です。ネットワークエラーが発生した場合は、空文字列が返されます。

+ +

生のヘッダー文字列がどのように見えるかの例です。

+ +
date: Fri, 08 Dec 2017 21:04:30 GMT\r\n
+content-encoding: gzip\r\n
+x-content-type-options: nosniff\r\n
+server: meinheld/0.6.1\r\n
+x-frame-options: DENY\r\n
+content-type: text/html; charset=utf-8\r\n
+connection: keep-alive\r\n
+strict-transport-security: max-age=63072000\r\n
+vary: Cookie, Accept-Encoding\r\n
+content-length: 6502\r\n
+x-xss-protection: 1; mode=block\r\n
+ +

各行はキャリッジリターンとラインフィード文字 (\r\n) の両方で終わります。これらはそれぞれのヘッダーを区切る基本的なデリミターです。

+ +
+

注: 最近のブラウザーでは、ヘッダー名は最新の仕様書にあるように、すべて小文字で返されます。

+
+ +

例

+ +

この例では、リクエストの {{event("readystatechange")}} イベントハンドラーである {{domxref("XMLHttpRequest.onreadystatechange")}} の中でヘッダーを調べます。このコードは生のヘッダー文字列を取得する方法、またそれを個別のヘッダーの配列に変換する方法、そして配列からヘッダー名とその値のマップを生成する方法を示しています。

+ +
var request = new XMLHttpRequest();
+request.open("GET", "foo.txt", true);
+request.send();
+
+request.onreadystatechange = function() {
+  if(this.readyState == this.HEADERS_RECEIVED) {
+
+    // 生のヘッダー文字列を取得
+    var headers = request.getAllResponseHeaders();
+
+    // ヘッダー文字列を個別のヘッダーの
+    // 配列に変換
+    var arr = headers.trim().split(/[\r\n]+/);
+
+    // ヘッダー名と値のマップを生成
+    var headerMap = {};
+    arr.forEach(function (line) {
+      var parts = line.split(': ');
+      var header = parts.shift();
+      var value = parts.join(': ');
+      headerMap[header] = value;
+    });
+  }
+}
+ +

いったんこれを行えば、次のようなことができます。

+ +
var contentType = headerMap["content-type"];
+ +

これは {{httpheader("Content-Type")}} ヘッダーの値を変数 contentType の中に入れます。

+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-getallresponseheaders()-method', 'getAllResponseHeaders()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの互換性

+ +
{{Compat("api.XMLHttpRequest.getAllResponseHeaders")}}
+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/getresponseheader/index.html b/files/ja/web/api/xmlhttprequest/getresponseheader/index.html deleted file mode 100644 index 73ef9e1a35..0000000000 --- a/files/ja/web/api/xmlhttprequest/getresponseheader/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: XMLHttpRequest.getResponseHeader() -slug: Web/API/XMLHttpRequest/getResponseHeader -tags: - - API - - HTTP - - HTTP ヘッダー - - Reference - - XHR - - XMLHttpRequest - - getResponseHeader - - ヘッダー - - ヘッダーの取得 - - メソッド -translation_of: Web/API/XMLHttpRequest/getResponseHeader ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{DOMxRef("XMLHttpRequest")}} の getResponseHeader() メソッドは、特定のヘッダー値のテキストを含んだ文字列を返します。同じ名前で複数のレスポンスヘッダーがあった場合、値はコンマと空白で区切って値を接続した単一の文字列として返されます。 getResponseHeader() メソッドは値を UTF バイトシーケンスとして返します。

- -
-

メモ: ヘッダー名の検索は、大文字小文字の区別がありません。

-
- -

ヘッダーすべての生の文字列を取得する必要がある場合は、生のヘッダー文字列全体を返す {{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}} メソッドを使用してください。

- -

構文

- -
var myHeader = XMLHttpRequest.getResponseHeader(headerName);
- -

引数

- -
-
headerName
-
{{DOMxRef("ByteString")}} で、テキスト値を取得したいヘッダーの名前を示します。
-
- -

返値

- -

ヘッダーのテキスト値を表す {{DOMxRef("ByteString")}}、または、レスポンスがまだ受信されていないか、そのヘッダーがレスポンスに存在しなければ null です。

- -

例

- -

この例では、リクエストが生成されて送信され、そして {{Event("readystatechange")}} ハンドラーを設定してヘッダーが純真で来たことを示す {{DOMxRef("XMLHttpRequest.readyState", "readyState")}} を監視します。その時が来たら、 {{httpheader("Content-Type")}} ヘッダーの値を読み取ります。 Content-Type が求められる値でない場合、 {{DOMxRef("XMLHttpRequest")}} は {{DOMxRef("XMLHttpRequest.abort", "abort()")}} を呼び出してキャンセルします。

- -
var client = new XMLHttpRequest();
-client.open("GET", "unicorns-are-teh-awesome.txt", true);
-client.send();
-
-client.onreadystatechange = function() {
-  if(this.readyState == this.HEADERS_RECEIVED) {
-    var contentType = client.getResponseHeader("Content-Type");
-    if (contentType != my_expected_type) {
-      client.abort();
-    }
-  }
-}
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName("XMLHttpRequest", "#dom-xmlhttprequest-getresponseheader", "getResponseHeader()")}}{{Spec2("XMLHttpRequest")}}WHATWG living standard
- -

ブラウザーの対応

- -
{{Compat("api.XMLHttpRequest.getResponseHeader")}}
- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/getresponseheader/index.md b/files/ja/web/api/xmlhttprequest/getresponseheader/index.md new file mode 100644 index 0000000000..73ef9e1a35 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/getresponseheader/index.md @@ -0,0 +1,90 @@ +--- +title: XMLHttpRequest.getResponseHeader() +slug: Web/API/XMLHttpRequest/getResponseHeader +tags: + - API + - HTTP + - HTTP ヘッダー + - Reference + - XHR + - XMLHttpRequest + - getResponseHeader + - ヘッダー + - ヘッダーの取得 + - メソッド +translation_of: Web/API/XMLHttpRequest/getResponseHeader +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{DOMxRef("XMLHttpRequest")}} の getResponseHeader() メソッドは、特定のヘッダー値のテキストを含んだ文字列を返します。同じ名前で複数のレスポンスヘッダーがあった場合、値はコンマと空白で区切って値を接続した単一の文字列として返されます。 getResponseHeader() メソッドは値を UTF バイトシーケンスとして返します。

+ +
+

メモ: ヘッダー名の検索は、大文字小文字の区別がありません。

+
+ +

ヘッダーすべての生の文字列を取得する必要がある場合は、生のヘッダー文字列全体を返す {{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}} メソッドを使用してください。

+ +

構文

+ +
var myHeader = XMLHttpRequest.getResponseHeader(headerName);
+ +

引数

+ +
+
headerName
+
{{DOMxRef("ByteString")}} で、テキスト値を取得したいヘッダーの名前を示します。
+
+ +

返値

+ +

ヘッダーのテキスト値を表す {{DOMxRef("ByteString")}}、または、レスポンスがまだ受信されていないか、そのヘッダーがレスポンスに存在しなければ null です。

+ +

例

+ +

この例では、リクエストが生成されて送信され、そして {{Event("readystatechange")}} ハンドラーを設定してヘッダーが純真で来たことを示す {{DOMxRef("XMLHttpRequest.readyState", "readyState")}} を監視します。その時が来たら、 {{httpheader("Content-Type")}} ヘッダーの値を読み取ります。 Content-Type が求められる値でない場合、 {{DOMxRef("XMLHttpRequest")}} は {{DOMxRef("XMLHttpRequest.abort", "abort()")}} を呼び出してキャンセルします。

+ +
var client = new XMLHttpRequest();
+client.open("GET", "unicorns-are-teh-awesome.txt", true);
+client.send();
+
+client.onreadystatechange = function() {
+  if(this.readyState == this.HEADERS_RECEIVED) {
+    var contentType = client.getResponseHeader("Content-Type");
+    if (contentType != my_expected_type) {
+      client.abort();
+    }
+  }
+}
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("XMLHttpRequest", "#dom-xmlhttprequest-getresponseheader", "getResponseHeader()")}}{{Spec2("XMLHttpRequest")}}WHATWG living standard
+ +

ブラウザーの対応

+ +
{{Compat("api.XMLHttpRequest.getResponseHeader")}}
+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/open/index.html b/files/ja/web/api/xmlhttprequest/open/index.html deleted file mode 100644 index 56f4408c98..0000000000 --- a/files/ja/web/api/xmlhttprequest/open/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: XMLHttpRequest.open() -slug: Web/API/XMLHttpRequest/open -tags: - - API - - HTTP - - Method - - Reference - - XHR - - XMLHttpRequest - - open - - メソッド -translation_of: Web/API/XMLHttpRequest/open ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の open() メソッドは、新しく作成されたリクエストを初期化したり、既存のリクエストを再初期化したりします。

- -
メモ: すでに有効なリクエスト (すでに open() が呼び出されたもの) に対してこのメソッドを呼び出すと、 {{domxref("XMLHttpRequest.abort", "abort()")}} を呼び出すのと等価になります。
- -

構文

- -
XMLHttpRequest.open(method, url[, async[, user[, password]]])
-
- -

引数

- -
-
method
-
使用する HTTP リクエストメソッドです。 "GET", "POST", "PUT", "DELETE", など。 HTTP(S) 以外の URL では無視されます。
-
url
-
リクエストを送信する URL を表す {{domxref("DOMString")}}。
-
async {{optional_inline}}
-
任意の論理値の引数で、既定値は trueです。操作が非同期的に行われるかどうかを示します。値が false の場合、 send() メソッドはレスポンスを受信するまで戻りません。 true の場合は、トランザクション完了の通知はイベントリスナーを使用して配信されます。 multipart 属性が true である場合は true でなければならず、さもなくば例外が発生します。 -
メモ: メインスレッドで同期リクエストを行うと、ユーザーの使い勝手を簡単に阻害するので避けるべきです。実際、多くのブラウザーではメインスレッドにおける同期的な XHR の対応を全面的に非推奨としています。同期リクエストは {{domxref("Worker")}} で許可されています。
-
-
user {{optional_inline}}
-
任意で、認証プロセスで使用するユーザー名です。既定では、これは null 値です。
-
password {{optional_inline}}
-
任意で、認証プロセスで使用するパスワードです。既定では、これは null 値です。
-
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-open()-method', 'open()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの互換性

- -

{{Compat("api.XMLHttpRequest.open")}}

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/open/index.md b/files/ja/web/api/xmlhttprequest/open/index.md new file mode 100644 index 0000000000..56f4408c98 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/open/index.md @@ -0,0 +1,71 @@ +--- +title: XMLHttpRequest.open() +slug: Web/API/XMLHttpRequest/open +tags: + - API + - HTTP + - Method + - Reference + - XHR + - XMLHttpRequest + - open + - メソッド +translation_of: Web/API/XMLHttpRequest/open +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の open() メソッドは、新しく作成されたリクエストを初期化したり、既存のリクエストを再初期化したりします。

+ +
メモ: すでに有効なリクエスト (すでに open() が呼び出されたもの) に対してこのメソッドを呼び出すと、 {{domxref("XMLHttpRequest.abort", "abort()")}} を呼び出すのと等価になります。
+ +

構文

+ +
XMLHttpRequest.open(method, url[, async[, user[, password]]])
+
+ +

引数

+ +
+
method
+
使用する HTTP リクエストメソッドです。 "GET", "POST", "PUT", "DELETE", など。 HTTP(S) 以外の URL では無視されます。
+
url
+
リクエストを送信する URL を表す {{domxref("DOMString")}}。
+
async {{optional_inline}}
+
任意の論理値の引数で、既定値は trueです。操作が非同期的に行われるかどうかを示します。値が false の場合、 send() メソッドはレスポンスを受信するまで戻りません。 true の場合は、トランザクション完了の通知はイベントリスナーを使用して配信されます。 multipart 属性が true である場合は true でなければならず、さもなくば例外が発生します。 +
メモ: メインスレッドで同期リクエストを行うと、ユーザーの使い勝手を簡単に阻害するので避けるべきです。実際、多くのブラウザーではメインスレッドにおける同期的な XHR の対応を全面的に非推奨としています。同期リクエストは {{domxref("Worker")}} で許可されています。
+
+
user {{optional_inline}}
+
任意で、認証プロセスで使用するユーザー名です。既定では、これは null 値です。
+
password {{optional_inline}}
+
任意で、認証プロセスで使用するパスワードです。既定では、これは null 値です。
+
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-open()-method', 'open()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの互換性

+ +

{{Compat("api.XMLHttpRequest.open")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/send/index.html b/files/ja/web/api/xmlhttprequest/send/index.html deleted file mode 100644 index cc98413966..0000000000 --- a/files/ja/web/api/xmlhttprequest/send/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: XMLHttpRequest.send() -slug: Web/API/XMLHttpRequest/send -tags: - - AJAX - - API - - HTTP リクエスト - - Reference - - XHR - - XHR リクエスト - - XMLHttpRequest - - send - - ウェブ - - メソッド -translation_of: Web/API/XMLHttpRequest/send ---- -
{{APIRef('XMLHttpRequest')}}
- -

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

- -

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

- -

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

- -

構文

- -
XMLHttpRequest.send(body)
-
- -

引数

- -
-
body {{optional_inline}}
-
XHR のリクエストの中で送られる本文データです。次のものが使用できます。 -
    -
  • {{domxref("Document")}}: 送信前にシリアライズされている場合。
    • -
  • BodyInit: Fetch の仕様書によれば、 {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, {{domxref("ReadableStream")}}, {{domxref("USVString")}} 型のオブジェクトが利用できます。
    • -
- body に値が設定されていない場合、既定値の null が使用されます。
-
- -

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

- -

返値

- -

undefined

- -

例外

- - - - - - - - - - - - - - - - - - -
例外説明
InvalidStateErrorこのリクエストに対してすでに send() が呼び出されているか、リクエストが完了している。
NetworkError読み込むリソースの型が Blob であり、メソッドが GET ではない。
- -

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 (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
-        // リクエストの終了。ここの処理を実行します。
-    }
-}
-xhr.send("foo=bar&lorem=ipsum");
-// xhr.send(new Int8Array());
-// xhr.send(document);
-
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-send()-method', 'send()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの対応

- -
{{Compat("api.XMLHttpRequest.send")}}
- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/send/index.md b/files/ja/web/api/xmlhttprequest/send/index.md new file mode 100644 index 0000000000..cc98413966 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/send/index.md @@ -0,0 +1,131 @@ +--- +title: XMLHttpRequest.send() +slug: Web/API/XMLHttpRequest/send +tags: + - AJAX + - API + - HTTP リクエスト + - Reference + - XHR + - XHR リクエスト + - XMLHttpRequest + - send + - ウェブ + - メソッド +translation_of: Web/API/XMLHttpRequest/send +--- +
{{APIRef('XMLHttpRequest')}}
+ +

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

+ +

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

+ +

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

+ +

構文

+ +
XMLHttpRequest.send(body)
+
+ +

引数

+ +
+
body {{optional_inline}}
+
XHR のリクエストの中で送られる本文データです。次のものが使用できます。 +
    +
  • {{domxref("Document")}}: 送信前にシリアライズされている場合。
    • +
  • BodyInit: Fetch の仕様書によれば、 {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, {{domxref("ReadableStream")}}, {{domxref("USVString")}} 型のオブジェクトが利用できます。
    • +
+ body に値が設定されていない場合、既定値の null が使用されます。
+
+ +

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

+ +

返値

+ +

undefined

+ +

例外

+ + + + + + + + + + + + + + + + + + +
例外説明
InvalidStateErrorこのリクエストに対してすでに send() が呼び出されているか、リクエストが完了している。
NetworkError読み込むリソースの型が Blob であり、メソッドが GET ではない。
+ +

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 (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
+        // リクエストの終了。ここの処理を実行します。
+    }
+}
+xhr.send("foo=bar&lorem=ipsum");
+// xhr.send(new Int8Array());
+// xhr.send(document);
+
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-send()-method', 'send()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの対応

+ +
{{Compat("api.XMLHttpRequest.send")}}
+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/setrequestheader/index.html b/files/ja/web/api/xmlhttprequest/setrequestheader/index.html deleted file mode 100644 index 41c8609690..0000000000 --- a/files/ja/web/api/xmlhttprequest/setrequestheader/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: XMLHttpRequest.setRequestHeader() -slug: Web/API/XMLHttpRequest/setRequestHeader -tags: - - API - - HTTP - - HTTP Header - - Method - - NeedsExample - - Reference - - Request header - - XHR - - XHR Request - - XMLHttpRequest - - header - - request - - setRequestHeader -translation_of: Web/API/XMLHttpRequest/setRequestHeader ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の setRequestHeader() メソッドは、 HTTP リクエストヘッダーの値を設定します。 setRequestHeader() は、 {{domxref("XMLHttpRequest.open", "open()")}} の呼び出しの後、 {{domxref("XMLHttpRequest.send", "send()")}} の呼び出しの前に呼び出さなければなりません。同じヘッダーについてこのメソッドを複数回呼び出された場合は、複数の値が単一のリクエストヘッダーにマージされます。

- -

最初に setRequestHeader() を呼び出した後、呼び出す度に、指定されたテキストは既存のヘッダーの内容の末尾に追加されます。

- -

この関数を使用して {{HTTPHeader("Accept")}} ヘッダーが設定されなかった場合、 {{domxref("XMLHttpRequest.send", "send()")}} が呼び出されると、 Accept ヘッダーは */* の値で送信されます。

- -

セキュリティ上の理由で、いくつかのヘッダは、ユーザエージェントからしか制御できません。これらのヘッダーには、 {{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}} および {{Glossary("Forbidden_response_header_name", "禁止レスポンスヘッダー名", 1)}} を含みます。

- -
-

注: カスタムフィールドについては、ドメインをまたがってリクエストを行うと、 "not allowed by Access-Control-Allow-Headers in preflight response" の例外に遭遇することがあります。この場合、サーバー側でレスポンスヘッダーに {{HTTPHeader("Access-Control-Allow-Headers")}} を設定する必要があります。

-
- -

構文

- -
XMLHttpRequest.setRequestHeader(header, value)
-
- -

引数

- -
-
header
-
値を設定するヘッダーの名前。
-
value
-
そのヘッダーの本体として設定する値。
-
- -

返値

- -

undefined です。

- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-setrequestheader()-method', 'setRequestHeader()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの互換性

- -

{{Compat("api.XMLHttpRequest.setRequestHeader")}}

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/setrequestheader/index.md b/files/ja/web/api/xmlhttprequest/setrequestheader/index.md new file mode 100644 index 0000000000..41c8609690 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/setrequestheader/index.md @@ -0,0 +1,80 @@ +--- +title: XMLHttpRequest.setRequestHeader() +slug: Web/API/XMLHttpRequest/setRequestHeader +tags: + - API + - HTTP + - HTTP Header + - Method + - NeedsExample + - Reference + - Request header + - XHR + - XHR Request + - XMLHttpRequest + - header + - request + - setRequestHeader +translation_of: Web/API/XMLHttpRequest/setRequestHeader +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の setRequestHeader() メソッドは、 HTTP リクエストヘッダーの値を設定します。 setRequestHeader() は、 {{domxref("XMLHttpRequest.open", "open()")}} の呼び出しの後、 {{domxref("XMLHttpRequest.send", "send()")}} の呼び出しの前に呼び出さなければなりません。同じヘッダーについてこのメソッドを複数回呼び出された場合は、複数の値が単一のリクエストヘッダーにマージされます。

+ +

最初に setRequestHeader() を呼び出した後、呼び出す度に、指定されたテキストは既存のヘッダーの内容の末尾に追加されます。

+ +

この関数を使用して {{HTTPHeader("Accept")}} ヘッダーが設定されなかった場合、 {{domxref("XMLHttpRequest.send", "send()")}} が呼び出されると、 Accept ヘッダーは */* の値で送信されます。

+ +

セキュリティ上の理由で、いくつかのヘッダは、ユーザエージェントからしか制御できません。これらのヘッダーには、 {{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}} および {{Glossary("Forbidden_response_header_name", "禁止レスポンスヘッダー名", 1)}} を含みます。

+ +
+

注: カスタムフィールドについては、ドメインをまたがってリクエストを行うと、 "not allowed by Access-Control-Allow-Headers in preflight response" の例外に遭遇することがあります。この場合、サーバー側でレスポンスヘッダーに {{HTTPHeader("Access-Control-Allow-Headers")}} を設定する必要があります。

+
+ +

構文

+ +
XMLHttpRequest.setRequestHeader(header, value)
+
+ +

引数

+ +
+
header
+
値を設定するヘッダーの名前。
+
value
+
そのヘッダーの本体として設定する値。
+
+ +

返値

+ +

undefined です。

+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-setrequestheader()-method', 'setRequestHeader()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの互換性

+ +

{{Compat("api.XMLHttpRequest.setRequestHeader")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf