files/ja/web/api/body/index.html


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

---
title: Body
slug: Web/API/Body
tags:
  - API
  - BODY
  - Experimental
  - Fetch
  - Fetch API
  - Interface
  - Reference
  - request
translation_of: Web/API/Body
---
<div>{{ APIRef("Fetch") }}</div>

<p><span class="seoSummary"><a href="/ja/docs/Web/API/Fetch_API">Fetch API</a> の <strong><code>Body</code></strong> {{glossary("mixin","ミックスイン")}}は、リクエスト/レスポンスのボディを表し、そのコンテンツタイプが何であるかとその処理方法を宣言できます。</span></p>

<p><code>Body</code> は {{domxref("Request")}} と {{domxref("Response")}} の両方で実装されます。 これにより、これらのオブジェクトに、関連するボディ（<a href="/ja/docs/Web/API/Streams_API">ストリーム</a>）と使用済みフラグ（初期は未設定）、MIME タイプ（初期は空のバイトシーケンス）が提供されます。（訳注：コンテンツタイプ（MIME タイプ）は、{{domxref("Headers")}} の <code>"Content-Type"</code> にあります。 でも、例を見てもわかる通り、普通はリクエストの時点で決定しているので、これを調べてはいません。）</p>

<h2 id="Properties" name="Properties">プロパティ</h2>

<dl>
 <dt>{{domxref("Body.body")}} {{readonlyInline}}</dt>
 <dd>ボディコンテンツの {{domxref("ReadableStream")}} を公開するために使用する単純なゲッター。</dd>
 <dt>{{domxref("Body.bodyUsed")}} {{readonlyInline}}</dt>
 <dd>既にボディが読み込まれたかどうかを示す {{jsxref("Boolean")}} 値。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<dl>
 <dt>{{domxref("Body.arrayBuffer()")}}</dt>
 <dd>{{domxref("Response")}} ストリームを取得し、完全に読み込む。 {{jsxref("ArrayBuffer")}} で解決する promise を返す。</dd>
 <dt>{{domxref("Body.blob()")}}</dt>
 <dd>{{domxref("Response")}} ストリームを取得し、完全に読み込む。 {{domxref("Blob")}} で解決する promise を返す。</dd>
 <dt>{{domxref("Body.formData()")}}</dt>
 <dd>{{domxref("Response")}} ストリームを取得し、完全に読み込む。 {{domxref("FormData")}} オブジェクトで解決する promise を返す。</dd>
 <dt>{{domxref("Body.json()")}}</dt>
 <dd>{{domxref("Response")}} ストリームを取得し、完全に読み込む。 ボディのテキストを {{jsxref("JSON")}} として解析した結果で解決する promise を返す。</dd>
 <dt>{{domxref("Body.text()")}}</dt>
 <dd>{{domxref("Response")}} ストリームを取得し、完全に読み込む。 {{domxref("USVString")}}（テキスト）で解決する promise を返す。 レスポンスは常に UTF-8 でデコードする。</dd>
</dl>

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

<p>次の例では、単純なフェッチ呼び出しを使用して画像を取得し、{{htmlelement("img")}} タグで表示します。 画像をリクエストしているので、{{domxref("Body.blob","Body.blob()")}} （{{domxref("Response")}} は <code>Body</code> を実装しています）を実行して、レスポンスに正しい MIME タイプを与える必要があることに注意してください。</p>

<h3 id="HTML_Content" name="HTML_Content">HTML の内容</h3>

<pre class="brush: html">&lt;img class="my-image" src="https://wikipedia.org/static/images/project-logos/frwiki-1.5x.png"&gt;
</pre>

<h3 id="JS_Content" name="JS_Content">JS の内容</h3>

<pre class="brush: js">const myImage = document.querySelector('.my-image');
fetch('https://upload.wikimedia.org/wikipedia/commons/7/77/Delete_key1.jpg')
	.then(res =&gt; res.blob())
	.then(res =&gt; {
		const objectURL = URL.createObjectURL(res);
		myImage.src = objectURL;
});</pre>

<p>{{ EmbedLiveSample('Examples', '100%', '250px') }}</p>

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

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

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>


<p>{{Compat("api.Body")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li>
 <li><a href="/ja/docs/Web/HTTP/CORS">HTTP アクセス制御 (CORS)</a></li>
 <li><a href="/ja/docs/Web/HTTP">HTTP</a></li>
</ul>