blob: 564ece1bef84a4dc29d3206d77fb68d37f803c8e (
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
|
---
title: FormData
slug: Web/API/FormData
tags:
- API
- FormData
- Interface
- Reference
- XMLHttpRequest
translation_of: Web/API/FormData
---
<p>{{APIRef("XMLHttpRequest")}}</p>
<p><strong><code>FormData</code></strong> インターフェイスは、{{domxref("XMLHttpRequest.send()")}} メソッドを用いることで簡単に送信が可能な、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは、エンコーディングタイプを <code>"multipart/form-data"</code> に設定した場合にフォームが使用するものと同じ形式を使用します。</p>
<p><code>FormData</code> を実装したオブジェクトは、{{domxref('FormData.entries()', 'entries()')}} の代わりに {{jsxref("Statements/for...of", "for...of")}} 構造の内部で直接使用できます。<code>for (var p of myFormData)</code> は <code>for (var p of myFormData.entries())</code> と等価です。</p>
<div class="note">
<p><strong>注記</strong>: この機能は <a href="/ja/docs/Web/API/Web_Workers_API">Web Workers</a> で使用できます。</p>
</div>
<h2 id="Constructor" name="Constructor">コンストラクタ</h2>
<dl>
<dt>{{domxref("FormData.FormData","FormData()")}}</dt>
<dd>新しい <code>FormData</code> オブジェクトを作成します。</dd>
</dl>
<h2 id="Methods" name="Methods">メソッド</h2>
<dl>
<dt>{{domxref("FormData.append()")}}</dt>
<dd><code>FormData</code> オブジェクト内の既存のキーに新たな値を追加するか、キーが存在しない場合はキーを追加します。</dd>
<dt>{{domxref("FormData.delete()")}}</dt>
<dd><code>FormData</code> オブジェクトからキーと値のペアを削除します。</dd>
<dt>{{domxref("FormData.entries()")}}</dt>
<dd>オブジェクトに含まれているすべてのキーと値のペアを走査できるようにするため、{{jsxref("Iteration_protocols","iterator")}} を返します。</dd>
<dt>{{domxref("FormData.get()")}}</dt>
<dd><code>FormData</code> オブジェクトから、指定したキーに関連付けられた最初の値を返します。</dd>
<dt>{{domxref("FormData.getAll()")}}</dt>
<dd><code>FormData</code> から、指定したキーに関連付けられたすべての値の配列を返します。</dd>
<dt>{{domxref("FormData.has()")}}</dt>
<dd><code>FormData</code> オブジェクトがあるキーと値のペアを持っているかを示す真偽値を返します。</dd>
<dt>{{domxref("FormData.keys()")}}</dt>
<dd>オブジェクト内に存在するキーと値のペアから、すべてのキーを走査できるようにするための {{jsxref("Iteration_protocols", "iterator")}} を返します。</dd>
<dt>{{domxref("FormData.set()")}}</dt>
<dd><code>FormData</code> オブジェクト内の既存のキーに新たな値を設定するか、キーが存在しない場合はキーと値のペアを追加します。</dd>
<dt>{{domxref("FormData.values()")}}</dt>
<dd>オブジェクト内に存在するキーと値のペアから、すべての値を走査できるようにするための {{jsxref("Iteration_protocols", "iterator")}} を返します。</dd>
</dl>
<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('XMLHttpRequest','#interface-formdata','FormData')}}</td>
<td>{{Spec2('XMLHttpRequest')}}</td>
<td>XHR 仕様書で FormData を定義</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>
<p>{{Compat("api.FormData")}}</p>
<h2 id="See_also" name="See_also">関連文書</h2>
<ul>
<li>{{domxref("XMLHTTPRequest")}}</li>
<li><a href="/ja/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest">XMLHttpRequest の利用</a></li>
<li><a href="/ja/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest#Using_FormData_objects">FormData オブジェクトの利用</a></li>
<li>{{HTMLElement("Form")}}</li>
</ul>
|
