https://chromestatus.com/feature/5066604734316544
https://xhr.spec.whatwg.org/#interface-formdata
これまでの FormData ではサブミットボタンは対象外でした
<form id="form1">
<input name="text" value="a">
<button id="submit" type="submit" name="submit" value="1">submit</button>
</form>
という HTML があるときに このフォームを FormData 化して中身を見ると
const fd = new FormData(form1)
console.log(Array.from(fd.entries()))
// [
// ['text', 'a']
// ]
となっていて submit は含まれません
2 つめの引数の submitter に submit ボタンを渡すと
const fd = new FormData(form1, submit)
console.log(Array.from(fd.entries()))
// [
// ['text', 'a']
// ['submit', '1']
// ]
という感じで含まれるようになります
true/false じゃなくて HTML 要素を渡すのはフォームの挙動に合わせるためです
フォームにはサブミットボタンを複数配置できます
その中で押されたボタンの情報だけが送信されます
このフォームの動きに合わせて どのサブミットボタンを押されたとするかを指定するためです
<form id="form1">
<input name="text" value="a">
<button id="submit1" type="submit" name="submit" value="1">1</button>
<button id="submit2" type="submit" name="submit" value="2">2</button>
<button id="submit3" type="submit" name="submit" value="3">3</button>
</form>
const fd = new FormData(form1, submit2)
console.log(Array.from(fd.entries()))
// [
// ['text', 'a']
// ['submit', '2']
// ]
個人的には フォームから FormData をつくることはほぼなくて JavaScript の変数上に持っているデータから作ることばかりな上に フォームに複数のサブミットボタンを配置することもほぼないので使う機会は特になさそうです
従来のフォームで作られた画面でサブミットは fetch を使ってバックグラウンドでやるように変更したい みたいな場合には便利になるのかもですね
