From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/headers/append/index.html | 141 ++++++++++++++++++++++++++++ files/ja/web/api/headers/delete/index.html | 87 +++++++++++++++++ files/ja/web/api/headers/entries/index.html | 54 +++++++++++ files/ja/web/api/headers/get/index.html | 89 ++++++++++++++++++ files/ja/web/api/headers/headers/index.html | 73 ++++++++++++++ files/ja/web/api/headers/index.html | 128 +++++++++++++++++++++++++ 6 files changed, 572 insertions(+) create mode 100644 files/ja/web/api/headers/append/index.html create mode 100644 files/ja/web/api/headers/delete/index.html create mode 100644 files/ja/web/api/headers/entries/index.html create mode 100644 files/ja/web/api/headers/get/index.html create mode 100644 files/ja/web/api/headers/headers/index.html create mode 100644 files/ja/web/api/headers/index.html (limited to 'files/ja/web/api/headers') diff --git a/files/ja/web/api/headers/append/index.html b/files/ja/web/api/headers/append/index.html new file mode 100644 index 0000000000..72ef52c0fb --- /dev/null +++ b/files/ja/web/api/headers/append/index.html @@ -0,0 +1,141 @@ +--- +title: Headers.append() +slug: Web/API/Headers/append +tags: + - API + - Append + - Experimental + - Fetch + - Method + - Reference +translation_of: Web/API/Headers/append +--- +

{{APIRef("Fetch")}}{{ SeeCompatTable() }}

+ +

{{domxref("Headers")}} インターフェースの append() メソッドは、Headers オブジェクト内の既存のヘッダに新しい値を追加します。または、既存のヘッダがない場合には、ヘッダを追加します。

+ +

{{domxref("Headers.set")}} と append() の違いは、特定のヘッダが既に存在して、複数の値を受け入れる場合、{{domxref("Headers.set")}} は既存の値を新しい値で上書きますが、append() は値の最後に新しい値を追加します。

+ +

セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでのみ制御できます。それらのヘッダは、{{Glossary("Forbidden_header_name", "forbidden header names", 1)}} と {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}} を含みます。

+ +

構文

+ +
myHeaders.append(name,value);
+ +

パラメータ

+ +
+
name
+
Headers オブジェクトに追加する HTTP ヘッダ名。
+
value
+
HTTP ヘッダに追加する値。
+
+ +

戻り値

+ +

Void。

+ +

例

+ +

空の Headers オブジェクトの生成はシンプルです：

+ +
var myHeaders = new Headers(); // 現在は空
+ +

append() を使用してヘッダを追加できます：

+ +
myHeaders.append('Content-Type', 'image/jpeg');
+myHeaders.get('Content-Type'); // 'image/jpeg' を返します。
+
+ +

特定のヘッダが既に存在する場合、append() はその値を指定した値に変更します。特定のヘッダが既に存在して複数の値を受け入れる場合、append() は値の末尾に新しい値を追加します：

+ +
myHeaders.append('Accept-Encoding', 'deflate');
+myHeaders.append('Accept-Encoding', 'gzip');
+myHeaders.getAll('Accept-Encoding'); // [ "deflate", "gzip" ] を返します。
+ +

古い値を新しい値で上書きするには、{{domxref("Headers.set")}} を使います。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様ステータスコメント
{{SpecName('Fetch','#dom-headers-append','append()')}}{{Spec2('Fetch')}} 
+ +

ブラウザ実装状況

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
機能ChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
基本サポート{{ CompatChrome(42) }}
+ {{ CompatChrome(41) }} behind pref
+  		{{ CompatGeckoDesktop(39)}}
+ 34 behind pref		{{ CompatNo }} +

29
+ 28 behind pref

+ 		{{ CompatNo }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
機能AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE PhoneOpera MobileSafari MobileChrome for Android
基本サポート{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}
+
+ +

関連項目

+ + diff --git a/files/ja/web/api/headers/delete/index.html b/files/ja/web/api/headers/delete/index.html new file mode 100644 index 0000000000..9f85c85af3 --- /dev/null +++ b/files/ja/web/api/headers/delete/index.html @@ -0,0 +1,87 @@ +--- +title: Headers.delete() +slug: Web/API/Headers/delete +tags: + - API + - Experimental + - Fetch + - Method + - Reference + - delete +translation_of: Web/API/Headers/delete +--- +
{{APIRef("Fetch")}}
+ +

{{domxref("Headers")}} インターフェイスの delete() メソッドは、現在の Headers オブジェクトからヘッダーを削除します。

+ +

このメソッドは、次の理由で {{jsxref("TypeError")}} をスローします。

+ + + +

セキュリティ上の理由から、一部のヘッダーはユーザーエージェントのみがコントローラーにすることができます。 これらのヘッダーには {{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}} および {{Glossary("Forbidden_response_header_name", "禁止レスンポンスヘッダー名", 1)}} が含まれます。

+ +

構文

+ +
myHeaders.delete(name);
+ +

引数

+ +
+
name
+
Headers オブジェクトから削除する HTTP ヘッダーの名前。
+
+ +

戻り値

+ +

Void.

+ +

Example

+ +

空の Headers オブジェクトの作成は簡単です。

+ +
var myHeaders = new Headers(); // Currently empty
+ +

{{domxref("Headers.append")}} を使用して、これにヘッダーを追加できます。

+ +
myHeaders.append('Content-Type', 'image/jpeg');
+myHeaders.get('Content-Type'); // Returns 'image/jpeg'
+
+ +

その後、再度削除できます。

+ +
myHeaders.delete('Content-Type');
+myHeaders.get('Content-Type'); // Returns null, as it has been deleted
+ +

仕様書

+ + + + + + + + + + + + + + +
仕様書StatusComment
{{SpecName('Fetch','#dom-headers-delete','delete()')}}{{Spec2('Fetch')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Headers.delete")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/headers/entries/index.html b/files/ja/web/api/headers/entries/index.html new file mode 100644 index 0000000000..1899112dca --- /dev/null +++ b/files/ja/web/api/headers/entries/index.html @@ -0,0 +1,54 @@ +--- +title: Headers.entries() +slug: Web/API/Headers/entries +translation_of: Web/API/Headers/entries +--- +
{{APIRef}}
+ +

Headers.entries() メソッドは {{jsxref("Iteration_protocols",'iterator')}} を返し、このオブジェクトに含まれるすべてのキーと値のペアを通過できるようにします。各ペアのキーと値は両方とも {{domxref("ByteString")}} オブジェクトです。

+ +
+

Note: このメソッドは Web Workers で使用できます。

+
+ +

構文

+ +
headers.entries();
+ +

戻り値

+ +

{{jsxref("Iteration_protocols","iterator")}} を返します。

+ +

例

+ +
// Headers テストオブジェクトを作成
+var myHeaders = new Headers();
+myHeaders.append('Content-Type', 'text/xml');
+myHeaders.append('Vary', 'Accept-Language');
+
+// キーと値のペアを表示
+for (var pair of myHeaders.entries()) {
+   console.log(pair[0]+ ': '+ pair[1]);
+}
+
+ +

結果

+ +
content-type: text/xml
+vary: Accept-Language
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.Headers.entries")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/api/headers/get/index.html b/files/ja/web/api/headers/get/index.html new file mode 100644 index 0000000000..cbb371c5f1 --- /dev/null +++ b/files/ja/web/api/headers/get/index.html @@ -0,0 +1,89 @@ +--- +title: Headers.get() +slug: Web/API/Headers/get +tags: + - API + - Experimental + - Fetch + - Headers + - Method + - Reference + - get +translation_of: Web/API/Headers/get +--- +
{{APIRef("Fetch")}}
+ +

{{domxref("Headers")}} インターフェイスの get() メソッドは、指定された名前の Headers オブジェクト内のヘッダーのすべての値の ByteString を返します。要求されたヘッダーが Headers オブジェクトに存在しない場合、null を返します。

+ +

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

+ +

構文

+ +
myHeaders.get(name);
+ +

引数

+ +
+
name
+
Headers オブジェクトから値を取得する HTTP ヘッダーの名前。指定された名前が HTTP ヘッダーの名前でない場合、このメソッドは {{jsxref("TypeError")}} を返します。名前は大文字と小文字を区別しません。
+
+ +

戻り値

+ +

取得したヘッダーの値を表す {{domxref("ByteString")}} シーケンス。このヘッダーが設定されていない場合は null を返します。

+ +

例

+ +

空の Headers オブジェクトの作成は簡単です。

+ +
var myHeaders = new Headers(); // 現在空です
+myHeaders.get('Not-Set'); // null を返します
+
+ +

{{domxref("Headers.append")}} を使用してヘッダーを追加し、get() を使用してヘッダーを取得できます。

+ +
myHeaders.append('Content-Type', 'image/jpeg');
+myHeaders.get('Content-Type'); // "image/jpeg" を返します
+
+ +

ヘッダーに複数の値が関連付けられている場合、ByteString には、Headers オブジェクトに追加された順序ですべての値が含まれます。

+ +
myHeaders.append('Accept-Encoding', 'deflate');
+myHeaders.append('Accept-Encoding', 'gzip');
+myHeaders.get('Accept-Encoding'); // "deflate,gzip" を返します
+
+ +
+

注: {{domxref("Headers.getAll")}} にはこの機能があり、{{domxref("Headers.get")}} は Headers オブジェクトに追加された最初の値のみを返します。最新の仕様では getAll() が削除され、すべての値を返すように get() が更新されました。

+
+ +

仕様書

+ + + + + + + + + + + + + + +
仕様書StatusComment
{{SpecName('Fetch','#dom-headers-get','get()')}}{{Spec2('Fetch')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Headers.get")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/headers/headers/index.html b/files/ja/web/api/headers/headers/index.html new file mode 100644 index 0000000000..d143c50f7b --- /dev/null +++ b/files/ja/web/api/headers/headers/index.html @@ -0,0 +1,73 @@ +--- +title: Headers() +slug: Web/API/Headers/Headers +translation_of: Web/API/Headers/Headers +--- +
{{APIRef("Fetch")}}
+ +

Headers() コンストラクターは新しい {{domxref("Headers")}} オブジェクトを生成します。

+ +

文法

+ +
var myHeaders = new Headers(init);
+ +

引数

+ +
+
init {{optional_inline}}
+
Headers に前もって設定したい HTTP headers を含むオブジェクト。これは {{domxref("ByteString")}} を持つ単純なオブジェクトリテラルか、既存の Headers オブジェクトのどちらかです。最後の例では、新しい Headers オブジェクトは既存の Headers オブジェクトからデータを継承します。
+
+ +

例

+ +

簡単に空の Headers オブジェクトを生成できます。

+ +
var myHeaders = new Headers(); // Currently empty
+ +

{{domxref("Headers.append")}} を使用してヘッダーを追加できます。

+ +
myHeaders.append('Content-Type', 'image/jpeg');
+myHeaders.get('Content-Type'); // Returns 'image/jpeg'
+
+ +

または、Headers オブジェクトの生成時に必要なヘッダーを追加することもできます。次のスニペットでは、新しい {{domxref("Headers")}} を作成し、コンストラクターに init オブジェクトを引数として渡してヘッダーを追加しています。

+ +
var httpHeaders = { 'Content-Type' : 'image/jpeg', 'Accept-Charset' : 'utf-8', 'X-My-Custom-Header' : 'Zeke are cool' };
+var myHeaders = new Headers(httpHeaders);
+ +

最初の Headers を init オブジェクトとして渡して、別の Headers オブジェクトを生成できます。

+ +
var secondHeadersObj = new Headers(myHeaders);
+secondHeadersObj.get('Content-Type'); // Would return 'image/jpeg' — it inherits it from the first headers object
+ +

仕様書

+ + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('Fetch','#dom-headers','Headers()')}}{{Spec2('Fetch')}}
+ +

ブラウザの対応

+ + + +


+ {{Compat("api.Headers.headers")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/headers/index.html b/files/ja/web/api/headers/index.html new file mode 100644 index 0000000000..ba3dea6c65 --- /dev/null +++ b/files/ja/web/api/headers/index.html @@ -0,0 +1,128 @@ +--- +title: Headers +slug: Web/API/Headers +tags: + - API + - Experimental + - Fetch + - Fetch API + - Headers + - Interface + - Reference +translation_of: Web/API/Headers +--- +

{{ APIRef("Fetch") }}

+ +

Fetch API の Headers インターフェースは、HTTP リクエストとレスポンスのヘッダ上のさまざまなアクションを実行します。これらのアクションには、取得や設定、追加、削除が含まれます。Headers オブジェクトは、最初は空で 0 個以上の名前と値のペアで構成される関連するヘッダリストを持っています。追加には {{domxref("Headers.append","append()")}}（{{anch("例")}} を見てください）のようなメソッドを使用できます。このインタフェースのすべてのメソッドで、ヘッダ名は大文字と小文字を区別しないバイトシーケンスにマッチしています。

+ +

セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでしか制御できません。それらのヘッダには、{{Glossary("Forbidden_header_name", "forbidden header names", 1)}} と {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}} が含まれます。

+ +

ヘッダは関連するガードも持っています。ガードは immutable か request、request-no-cors、response、none のいずれかの値を取ります。これはヘッダを変更する {{domxref("Headers.set","set()")}} メソッドと {{domxref("Headers.delete","delete()")}} メソッド、{{domxref("Headers.append","append()")}} メソッドに影響を与えます。詳細は {{Glossary("Guard")}} を見てください。

+ +

{{domxref("Request.headers")}} プロパティと {{domxref("Response.headers")}} プロパティ経由で Headers オブジェクトを取得することも、{{domxref("Headers.Headers()")}} コンストラクタを使用して新しい Headers オブジェクトを生成することもできます。

+ +

Headers を実装したオブジェクトは、{{domxref('Headers.entries()', 'entries()')}} の代わりに直接 {{jsxref("Statements/for...of", "for...of")}} 構文で使用できます： for (var p of myHeaders) と for (var p of myHeaders.entries()) は同等です。

+ +
+

ノート： 利用できるヘッダについてはHTTP ヘッダ を参照してください。

+
+ +

コンストラクタ

+ +
+
{{domxref("Headers.Headers()")}}
+
新しい Headers オブジェクトを生成する。
+
+ +

メソッド

+ +
+
{{domxref("Headers.append()")}}
+
Headers オブジェクト内の既存のヘッダに新しい値を追加するか、まだ存在しない場合はヘッダを追加する。
+
{{domxref("Headers.delete()")}}
+
Headers オブジェクトからヘッダを削除する。
+
{{domxref("Headers.entries()")}}
+
このオブジェクトに含まれるすべてのキー/値 ペアを通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。
+
{{domxref("Headers.get()")}}
+
Headers オブジェクト内から指定したヘッダのすべての値の {{domxref("ByteString")}} を返す。
+
{{domxref("Headers.has()")}}
+
Headers オブジェクトが特定のヘッダを含むかどうかを示す boolean 値を返す。
+
{{domxref("Headers.keys()")}}
+
このオブジェクトに含まれるキー/値 ペアのすべてのキーを通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。
+
{{domxref("Headers.set()")}}
+
オブジェクト内の既存のヘッダに新しい値を設定するか、まだ存在しない場合はヘッダを追加する。
+
{{domxref("Headers.values()")}}
+
このオブジェクトに含まれるキー/値 ペアのすべての値を通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。
+
+ +
+

ノート： {{domxref("Headers.set()")}} と {{domxref("Headers.append()")}} の明確な違いは、複数の値を受け入れる特定のヘッダが既に存在しているときの挙動です。{{domxref("Headers.set()")}} は既存の値を新しい値で上書きしますが、{{domxref("Headers.append()")}} は既存の値の末尾に新しい値を追加します。サンプルコードはそれぞれの専用ページで確認してください。

+
+ +
+

ノート： 有効な HTTP ヘッダ名 ではない名前の参照を渡そうとすると、すべての Headers メソッドは TypeError をスローします。ヘッダに immutable {{Glossary("Guard")}} がある場合、変更操作は TypeError をスローします。そのほかの場外の場合は、単にに失敗します。

+
+ +
+

ノート：ヘッダーをイテレートする時、自動的に辞書順への並び替えが行われ、重複する名前は結合されます。

+
+ +

廃止になった機能

+ +
+
{{domxref("Headers.getAll()")}}
+
Headers オブジェクト内で指定されたヘッダのすべての値を配列として返す。このメソッドは規格から削除されており、 {{domxref("Headers.get()")}} は現在では与えられた名前に一致する最初のものを返します。
+
+ +

例

+ +

次のコードスニペットでは、Headers() コンストラクタを使用して新しいヘッダを生成し、append() を使用して新しいヘッダを追加しています。その後、get() を使用してヘッダの値を返しています：

+ +
var myHeaders = new Headers();
+
+myHeaders.append('Content-Type', 'text/xml');
+myHeaders.get('Content-Type') // 'text/xml' を返す。
+ +

同じことがコンストラクタにオブジェクトリテラルか配列リテラルの配列リテラルを渡すことでできます。

+ +
var myHeaders = new Headers({
+    'Content-Type': 'text/xml'
+});
+
+// or, using an array of arrays:
+myHeaders = new Headers([
+    ['Content-Type', 'text/xml']
+]);
+
+myHeaders.get('Content-Type') // should return 'text/xml'
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Fetch','#headers-class','Headers')}}{{Spec2('Fetch')}}
+ +

ブラウザ実装状況

+ + + +

{{Compat("api.Headers")}}

+ +

関連項目

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