From 2d51d3cc6c2d97bca7365fc4c83b10a085626477 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 30 Jan 2022 00:04:19 +0900 Subject: 2021/09/15 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../api/xmlhttprequest/setrequestheader/index.md | 82 +++++++++------------- 1 file changed, 32 insertions(+), 50 deletions(-) (limited to 'files/ja') diff --git a/files/ja/web/api/xmlhttprequest/setrequestheader/index.md b/files/ja/web/api/xmlhttprequest/setrequestheader/index.md index 41c8609690..6a377a58f9 100644 --- a/files/ja/web/api/xmlhttprequest/setrequestheader/index.md +++ b/files/ja/web/api/xmlhttprequest/setrequestheader/index.md @@ -4,77 +4,59 @@ slug: Web/API/XMLHttpRequest/setRequestHeader tags: - API - HTTP - - HTTP Header - - Method + - HTTP ヘッダー + - メソッド - NeedsExample - - Reference - - Request header + - リファレンス + - リクエストヘッダー - XHR - - XHR Request + - XHR リクエスト - XMLHttpRequest - - header + - ヘッダー - request - setRequestHeader +browser-compat: api.XMLHttpRequest.setRequestHeader translation_of: Web/API/XMLHttpRequest/setRequestHeader --- -
{{APIRef('XMLHttpRequest')}}
+{{APIRef('XMLHttpRequest')}} -

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

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

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

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

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

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

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

+セキュリティ上の理由で、いくつかのヘッダは、ユーザエージェントからしか制御できません。これらのヘッダーには、 {{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")}} を設定する必要があります。

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

構文

+## 構文 -
XMLHttpRequest.setRequestHeader(header, value)
-
+```js +XMLHttpRequest.setRequestHeader(header, value) +``` -

引数

+### 引数 -
-
header
-
値を設定するヘッダーの名前。
-
value
-
そのヘッダーの本体として設定する値。
-
+- `header` + - : 値を設定するヘッダーの名前。 +- `value` + - : そのヘッダーの本体として設定する値。 -

返値

+### 返値 -

undefined です。

+`undefined` です。 -

仕様書

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

ブラウザーの互換性

+## ブラウザーの互換性 -

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

+{{Compat}} -

関連情報

+## 関連情報 - +- [XMLHttpRequest の使用](/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- [XMLHttpRequest での HTML](/ja/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest) -- cgit v1.2.3-54-g00ecf