過去表單只能以 key-value 對的形式送到伺服器,這種格式對資料組織幾乎毫無管理能力,巢狀結構、陣列、布林值全都得靠字串拼接與約定俗成的命名(像是 user[name])硬湊。以 JSON 編碼提交表單,是 HTML 對 Web 演進的又一份貢獻:表單內所有欄位會被轉換成結構化的 JSON,伺服器端收到的就是一份現成可用的 JSON。
你應該很熟悉檔案上傳的寫法——在 <form> 上加 enctype="multipart/form-data",那是告訴瀏覽器改用上傳模式送出表單。JSON 提交如法炮製:
<form enctype='application/json'>
...
</form>
這是一項相當新的編碼方式,只有實作該規範的瀏覽器才認得 application/json 的語義並正確打包。至於舊式或尚未實作的瀏覽器,由於看不懂這個值,enctype 會自動退化為預設的 application/x-www-form-urlencoded。因此伺服器端最好依 enctype 的值判斷如何解析——這也是一個溫和而安全的降級策略。
實務上要留意:這屬於規範層面定義的編碼方式,瀏覽器的實作普及度一直有限,多數專案目前仍是在前端自行把表單序列化成 JSON 後送出。若要用,記得先驗證目標瀏覽器的支援情形。
<form enctype='application/json'>
<input name='name' value='Bender'>
<select name='hind'>
<option selected>Bitable</option>
<option>Kickable</option>
</select>
<input type='checkbox' name='shiny' checked>
</form>
// 產生的 JSON
{
"name": "Bender",
"hind": "Bitable",
"shiny": true
}
注意核取方塊的布林值被正確還原成 true,而不是字串 "on"。
<form enctype='application/json'>
<input type='number' name='bottle-on-wall' value='1'>
<input type='number' name='bottle-on-wall' value='2'>
<input type='number' name='bottle-on-wall' value='3'>
</form>
// 產生的 JSON
{
"bottle-on-wall": [1, 2, 3]
}
<form enctype='application/json'>
<input name='pet[species]' value='Dahut'>
<input name='pet[name]' value='Hypatia'>
<input name='kids[1]' value='Thelma'>
<input name='kids[0]' value='Ashley'>
</form>
// 產生的 JSON
{
"pet": {
"species": "Dahut",
"name": "Hypatia"
},
"kids": ["Ashley", "Thelma"]
}
即使 kids[1] 寫在 kids[0] 前面,輸出仍會依序號排好。
<form enctype='application/json'>
<input name='heartbeat[0]' value='thunk'>
<input name='heartbeat[2]' value='thunk'>
</form>
// 產生的 JSON
{
"heartbeat": ["thunk", null, "thunk"]
}
<form enctype='application/json'>
<input name='pet[0][species]' value='Dahut'>
<input name='pet[0][name]' value='Hypatia'>
<input name='pet[1][species]' value='Felis Stultus'>
<input name='pet[1][name]' value='Billy'>
</form>
// 產生的 JSON
{
"pet": [
{ "species": "Dahut", "name": "Hypatia" },
{ "species": "Felis Stultus", "name": "Billy" }
]
}
<form enctype='application/json'>
<input name='wow[such][deep][3][much][power][!]' value='Amaze'>
</form>
// 產生的 JSON
{
"wow": {
"such": {
"deep": [
null,
null,
null,
{
"much": {
"power": { "!": "Amaze" }
}
}
]
}
}
}
<form enctype='application/json'>
<input type='file' name='file' multiple>
</form>
// 假設上傳了兩個檔案,產生的 JSON
{
"file": [
{
"type": "text/plain",
"name": "dahut.txt",
"body": "REFBQUFBQUFIVVVVVVVVVVVVVCEhIQo="
},
{
"type": "text/plain",
"name": "litany.txt",
"body": "SSBtdXN0IG5vdCBmZWFyLlxuRmVhciBpcyB0aGUgbWluZC1raWxsZXIuCg=="
}
]
}
檔案內容會以 Base64 編碼放進 body 欄位。這也提醒我們:若表單裡有大檔案,JSON 模式會讓整包資料變成純文字傳輸,體積與記憶體開銷都要事先評估,這種情境通常還是 multipart/form-data 更合適。
enctype="application/json" 的價值在於讓表單直接產出結構化資料,省掉前端手動序列化的一整段程式,也讓伺服器端拿到乾淨的 JSON。理解它的編碼規則(同名收陣列、中括號建巢狀、缺號補 null)之後,是否採用就取決於你的瀏覽器支援範圍與資料型態了。