--- title: FormDataEvent.formData slug: Web/API/FormDataEvent/formData tags: - API - Experimental - FormDataEvent - Forms - Property - Reference browser-compat: api.FormDataEvent.formData translation_of: Web/API/FormDataEvent/formData ---
{{APIRef("DOM")}}

formData は {{domxref("FormDataEvent")}} インターフェイスの読み取り専用プロパティで、このイベントが発行された時点のフォームに含まれていたデータを表す {{domxref("FormData")}} オブジェクトが入っています。

構文

formData = formDataEvent.formData

返値

{{domxref("FormData")}} オブジェクト

例

// フォームの参照を取得

const formElem = document.querySelector('form');

// submit ハンドラー

formElem.addEventListener('submit', (e) => {
  // フォームの送信時、既定の動作を抑止
  e.preventDefault();

  // FormData オブジェクトを構築、これにより formdata イベントが発行
  new FormData(formElem);
});

// データを取得するための formdata ハンドラー

formElem.addEventListener('formdata', (e) => {
  console.log('formdata fired');

  // イベントオブジェクトからのフォームデータの取得
  let data = e.formData;
  for (var value of data.values()) {
    console.log(value);
  }

  // XHR を介してデータを送信
  var request = new XMLHttpRequest();
  request.open("POST", "/formHandler");
  request.send(data);
});

仕様書

{{Specifications}}

ブラウザーの互換性

{{Compat}}

関連情報