この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。HTML StandardとMDNのAPI説明を参照し、比較教材を用意しました。ブラウザー実操作は未確認です。
検証ステータス:📘 公式情報参照・静的確認/ブラウザー未検証
requestSubmit()とsubmit()は何が違う?フォーム送信の落とし穴
JavaScriptからHTMLフォームを送信するとき、form.requestSubmit()とform.submit()は同じ動作ではありません。前者は通常の送信ボタン操作に近く、制約検証とsubmitイベントを経由します。後者はそれらを迂回します。フォームの入力チェックや送信前の確認処理を実装する際に重要な違いです。
まず動かす
ライブデモ(公開URL到達未確認)を開き、氏名を空欄にして「requestSubmitを呼ぶ」を押してください。必須入力の制約によりinvalidイベントが記録され、submitイベントは発火しません。
次に「山田(架空)」と入力して同じ操作をします。今度はsubmitイベントが発火し、ログにaction=saveが表示されます。デモはイベント内でpreventDefault()を呼ぶので、外部へ送信しません。
| 操作 | 期待される結果 |
|---|---|
| 氏名空欄でrequestSubmit | invalid、submitなし |
| 氏名入力後にrequestSubmit | submitが発火し、送信を中止 |
| form.submit() | 制約検証とsubmitイベントを迂回。安全のためデモでは呼ばない |
最小コードで仕組みを理解する
<form id="sample">
<input name="person" required>
<button id="save" type="submit" name="action" value="save">保存</button>
</form>
<script>
const form = document.querySelector("#sample");
form.addEventListener("submit", event => {
event.preventDefault();
console.log("送信ボタン:", event.submitter?.value);
});
form.requestSubmit(document.querySelector("#save"));
</script>
この例は入力が空欄なので、submitイベントまで進みません。値を入れたあとに送信を要求すると、イベントが発火します。event.submitterは送信元のボタンを指し、複数ボタンのあるフォームでどの操作を選んだかを区別できます。
requestSubmit(button)に渡すのは送信ボタンです。フォームに属さないボタンや不適切な要素を指定すると例外になるため、対象を明示的に管理してください。引数なしでも呼べますが、複数ボタンを区別したい場合はボタンを渡す設計が分かりやすいでしょう。
form.submit()は、制約検証もsubmitイベントも通さず送信を開始します。したがってsubmitイベント内のpreventDefault()では止められません。デモでこのメソッドを実行せず説明だけ表示するのは、意図しないページ遷移を防ぐためです。
1か所変えてみる
HTMLのrequired属性を外し、空欄で再度requestSubmitを呼んでください。今度はsubmitイベントへ進むはずです。入力検証はJavaScriptの独自条件ではなく、ブラウザーがフォームの送信処理の中で実施していると分かります。
次にrequiredを戻し、値を入力した状態で「通常送信」を押します。requestSubmitと同じくsubmitイベントが記録されます。この比較から、ユーザーのボタン操作とプログラムによる送信要求を揃えたい場合にrequestSubmitが適する理由が理解できます。
実務ではどう使うか
例えば業務申請フォームに「保存」と「確認」の2つのボタンがある場合、ボタンのnameとvalueで処理を区別できます。JavaScriptから保存処理を要求するときにrequestSubmit(保存ボタン)を使えば、送信元を明示できます。
ただし、ブラウザーのrequiredは安全性を保証するものではありません。HTTPクライアントから直接リクエストを送れば、クライアント側の検証を通らずに値を送れます。サーバー側で必須項目、権限、操作種別、CSRF対策を別途検証してください。
また、フォームのコントロールにname="submit"を付けると、フォームのsubmitメソッドを覆い隠して呼べなくなることがあります。メソッドが見つからない場合は名前の衝突も確認します。
失敗時の切り分け
ログが出ない場合はapp.jsの読み込みエラーを確認します。空欄でsubmitが出ないのはrequiredによる正常な動作なので、invalidログを見てください。入力済みでもsubmitが出なければ、別の制約が失敗していないか調べます。古いブラウザーでrequestSubmitが未対応の場合は対応状況を確認し、安易にsubmitへ置き換えないでください。
教材は架空の氏名だけを扱い、CDN、外部API、保存処理を使いません。ブラウザーでの実操作と公開URL到達は未検証です。
