---
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>