aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/request/headers/index.html
blob: d5760737fca2692e68f9b976f8422ce985705a99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
---
title: Request.headers
slug: Web/API/Request/headers
tags:
  - API
  - Experimental
  - Fetch
  - Headers
  - Property
  - Reference
  - request
translation_of: Web/API/Request/headers
---
<div>{{APIRef("Fetch")}}{{SeeCompatTable}}</div>

<p>{{domxref("Request")}} のインターフェースの <strong><code>headers</code></strong> 読み取り専用プロパティは、リクエストに関連する {{domxref("Headers")}} オブジェクトを含みます。</p>

<h2 id="構文">構文</h2>

<pre class="syntaxbox">var <var>myHeaders</var> = <var>request</var>.headers;</pre>

<h3 id="値"></h3>

<p>{{domxref("Headers")}} オブジェクト。</p>

<h2 id="例"></h2>

<p>次のスニペットは、{{domxref("Request.Request()")}} コンストラクタを使って(スクリプトと同じディレクトリにある画像ファイルのために)新しいリクエストを生成してから、リクエストの headersを変数に保存しています:</p>

<pre class="brush: js">var myRequest = new Request('flowers.jpg');
var myHeaders = myRequest.headers; // Headers {}</pre>

<p>{{domxref("Headers")}} オブジェクトにヘッダを追加するためには、{{domxref("Headers.append")}} を使用します。初期化オプションとしてのヘッダを渡し、 2番目の初期化パラメータと一緒に新しい request を生成ます:</p>

<pre class="brush: js">var myHeaders = new Headers();
myHeaders.append('Content-Type', 'image/jpeg');

var myInit = { method: 'GET',
                   headers: myHeaders,
                   mode: 'cors',
                   cache: 'default' };

var myRequest = new Request('flowers.jpg',myInit);

myContentType = myRequest.headers.get('Content-Type'); // 'image/jpeg' を返す。</pre>

<h2 id="仕様">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('Fetch','#dom-request-headers','headers')}}</td>
   <td>{{Spec2('Fetch')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>{{CompatChrome(42)}}<br>
    {{CompatChrome(41)}}<sup>[1]</sup></td>
   <td>{{CompatGeckoDesktop(39)}}<br>
    34<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>
    <p>29<br>
     28<sup>[1]</sup></p>
   </td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] この機能は設定によって使えるようになります。</p>

<h2 id="関連項目">関連項目</h2>

<ul>
 <li><a href="/ja/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li>
 <li><a href="/ja/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li>
 <li><a href="/ja/docs/Web/HTTP">HTTP</a></li>
</ul>