入力値の取得と送信
フォームの入力値を取り出し、httpbin.org/post へJSONとして送信するところまでを実装します。ここでは、fetch の失敗を「ネットワークエラー」と「サーバがエラーステータスを返した場合」の両方で捕捉できるようにします。
フォームには、送信ボタンが押されたときやEnterキーで送信されたときに発火する submit イベントがあります。ブラウザは既定でsubmitを受け取るとページ遷移(またはリロード)を行うため、JavaScriptから通信を制御する場合は event.preventDefault() で既定動作を止める必要があります。書き方は以下のとおりです。
フォーム要素.addEventListener("submit", (event) => {
event.preventDefault();
// 送信処理
});
入力要素の値は .value プロパティから読み出せます。<input> でも <textarea> でも同じ書き方で取得できます。
fetch は第2引数のオプションで、HTTPメソッド・ヘッダ・ボディを指定できます。ここで注意したいのは、fetch のPromiseは「HTTPリクエストが送れて、レスポンスが返ってきた」時点で解決されるという点です。サーバが 404 Not Found や 500 Internal Server Error を返しても、Promiseは成功(resolve)として解決されます。
成功レスポンス(2xx)とエラーレスポンス(4xx / 5xx)を区別するには、レスポンスオブジェクトの ok プロパティを確認します。書き方は以下のとおりです。
if (!response.ok) {
throw new Error("エラーメッセージ");
}
response.ok は、HTTPステータスが 200〜299 の範囲にあるときだけ true になります。それ以外のステータスでは false となるため、明示的に throw してエラー扱いにしないと、失敗レスポンスがそのまま then 側に流れてしまいます。
app.js の作成と実装
上で確認したsubmitイベントとfetchの書き方を組み合わせて、app.js にフォーム送信の処理を実装します。まず、app.js を作成します。Visual Studio Codeのエクスプローラーで frontend-contact-form フォルダを右クリックし、「新しいファイル」を選択して app.js という名前で作成してください。
frontend-contact-form/
├── index.html
├── style.css
└── app.js ← このファイルを作成
これは、submit イベントを捕まえて入力値を送信し、成功時はレスポンスの内容を、失敗時はエラーメッセージを画面に表示するコードです。作成した app.js に以下の内容を記述して保存します。
const form = document.querySelector("#contact-form");
const status = document.querySelector("#status");
form.addEventListener("submit", async (event) => {
event.preventDefault();
const payload = {
name: document.querySelector("#name").value,
message: document.querySelector("#message").value,
};
try {
const response = await fetch("https://httpbin.org/post", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
if (!response.ok) {
throw new Error(`サーバがエラーを返しました(${response.status})`);
}
const data = await response.json();
status.textContent = `送信に成功しました。サーバに届いた内容: ${JSON.stringify(data.json)}`;
} catch (error) {
status.textContent = `送信に失敗しました: ${error.message}`;
}
});
1. 動作確認
ブラウザで index.html を再読み込みし、名前とお問い合わせ内容を入力します。
「送信」ボタンを押すと、フォームの上に配置した <p id="status"> に、以下のような送信結果が表示されます。
送信に成功しました。サーバに届いた内容: {...} の形で、入力した名前とお問い合わせ内容がそのまま画面に返ってきます。入力内容がそのまま画面に反映されていることが動作確認のポイントで、fetch の POST リクエストが httpbin.org に届き、httpbin.org/post が返す json フィールドを取り出して画面に反映できていることが確認できます。これで「入力 → 送信 → レスポンス表示」の骨格が動くようになりました。
2. コード解説
submit イベントを捕まえてから fetch でPOST送信するまでの流れを、キーとなる部分ごとに見ていきます。
form.addEventListener("submit", async (event) => {
event.preventDefault();
コールバックに async を付けているのは、この中で await を使うためです。フォームの既定動作を止めてから、非同期の送信処理へ進みます。
const payload = {
name: document.querySelector("#name").value,
message: document.querySelector("#message").value,
};
<input> と <textarea> の .value プロパティで、入力された文字列を取り出してJavaScriptのオブジェクトにまとめています。
const response = await fetch("https://httpbin.org/post", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
fetch の第2引数で、HTTPメソッド・ヘッダ・ボディを指定しています。JSONを送るときは、Content-Type に application/json を指定し、JSON.stringify でオブジェクトを文字列化して body に渡す組み合わせが一般的です。
if (!response.ok) {
throw new Error(`サーバがエラーを返しました(${response.status})`);
}
response.ok を確認し、false(4xx / 5xx)だった場合は自分でエラーを投げて catch 側に処理を流します。この1行を書かないと、たとえば「送信先URLを打ち間違えて404が返った」ケースを成功扱いしてしまい、あとの data.json を読む時点で予期しない動作をします。
} catch (error) {
status.textContent = `送信に失敗しました: ${error.message}`;
}
ネットワーク切断など通信そのものの失敗と、上で自分で throw したHTTPステータスエラーの両方が、この catch ブロックに流れてきます。ユーザには「何が起きたか」を1行のメッセージで示します。
| 💡 ポイント |
|---|
fetch は成功レスポンスとエラーレスポンスの区別をアプリケーション側に任せる設計になっています。この点は axios などのHTTPクライアントライブラリと異なります(axios は既定で 4xx / 5xx を例外として投げます)。fetch を使う場合は、response.ok の判定を書き忘れないよう意識してください。 |