JavaScriptのFormDataオブジェクトの使い方を現役エンジニアが解説【初心者向け】

初心者向けにJavaScriptのFormDataオブジェクトの使い方について解説しています。FormDataオブジェクトは、XMLHttpRequestを使ってデータを送信するためのキーと値のセットを追加することが出来ます。フォームとは分離して使うことが出来ます。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

JavaScriptのFormDataオブジェクトの使い方について解説します。実際のコードをもとに解説していきますので、理解を深めていきましょう。

また、入門向けのJavaSriptを学習できるサイトも紹介しているので、合わせてご覧ください。

 

なお本記事は、オンラインブートキャンプ フロントエンドコース(JavaScript・jQuery講座)の内容をもとにしています。

 

田島悠介

今回は、JavaScriptに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

FormDataオブジェクトの使い方について詳しく説明していくね!

大石ゆかり

お願いします!

 

FormDataオブジェクトとは

FormDataオブジェクトとは、サーバーにデータを送信する際に使用するオブジェクトです。ユーザーが入力するフォームデータや、任意のデータをサーバーに送信できます。

実際の値はキーと値のペアです。FormDataオブジェクトについて、詳しくは以下の記事を参考にしてください。

https://developer.mozilla.org/ja/docs/Web/Guide/Using_FormData_Objects

 

FormDataオブジェクトの使い方

FormData オブジェクトの使い方は以下の通りです。newキーワードでインスタンスを作成し、appendメソッドでキーと値を追加していきます。

var formData = new FormData();
formData.append("キー", "値");

HTMLの<form>要素からFormDataオブジェクトを作成することもできます。

var formData = new FormData(document.forms.form1);

 

[PR] JavaScript・jQueryで挫折しない学習方法を動画で公開中

実際に書いてみよう

今回のサンプルプログラムでは、HTMLの<form>要素からFormDataオブジェクトを作成し、さらにJavaScript上でFormDataインスタンスに値を追加します。最後にFormDataインスタンスの内容をコンソールに表示します。

コンソールはブラウザがChromeの場合はデベロッパーツールで確認できます。

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8" />
  <title>sample</title>
</head>
<body>
  <form id="form1" action="#" onsubmit="return func1()">
    <input type="text" id="input_message" name="input_message" value="">
    <input type="checkbox" id="input_check" name="input_check" value="oncheck" checked>
    <input type="submit" value="送信">
  </form>
  <div id="output_message"></div>
  <script language="javascript" type="text/javascript">
    function func1() {
      var formData = new FormData(document.forms.form1);
      formData.append("key1", "value1");
      for (item of formData) {
        console.log(item);
      }
      return false;
    }
  </script>
</body>
</html>

実行結果は以下のようになります。HTMLの<form>要素内の値と、appendで追加したキーと値が出力されているのが確認できます。

 

筆者プロフィール

この記事を監修してくれた方

太田和樹(おおたかずき)

ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

また、TechAcademyではJavaScriptを使ってWebサービスを公開できるオンラインブートキャンプ フロントエンドコース(JavaScript・jQuery講座)を開催しています。

プログラミングの初心者でも受講可能です。Webサイトの表現の幅を広げたいという方はぜひご覧ください。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。