enctype 決定表單資料「用什麼格式打包送出」。JavaScript 對應的屬性是 form.enctype,讀寫都很簡單。
<form id="frm1" enctype="text/plain">
First name: <input type="text" name="fname" value="Donald"><br>
Last name: <input type="text" name="lname" value="Duck"><br>
</form>
<p>表單資料會以這種類型編碼:
<script>
document.write(document.getElementById('frm1').enctype);
</script>
</p>
輸出為 text/plain。
application/x-www-form-urlencodedkey=value&key2=value2。適合純文字欄位,但無法傳送檔案。multipart/form-datatext/plain表單裡有 <input type="file"> 卻沒設 enctype,伺服器收到的檔案部分會是空的或損壞。正確寫法:
<form id="uploadForm" enctype="multipart/form-data" method="post"> <input type="file" name="photo" accept="image/*"> <button type="submit">上傳</button> </form>
用 JavaScript 動態設定也可以:
document.getElementById('uploadForm').enctype = 'multipart/form-data';
但要留意:若表單中沒有任何 file 欄位,多數瀏覽器會忽略 multipart 設定而改用 urlencoded。因此讀取 form.enctype 時,得到的不一定是實際編碼方式。
如果用 fetch 送出,enctype 屬性實際上不再生效——編碼方式取決於你傳入的 body:
const form = document.getElementById('uploadForm');
// 傳 FormData:瀏覽器自動採用 multipart,並自行產生 boundary
fetch('/api/upload', { method: 'POST', body: new FormData(form) });
// 傳 URLSearchParams:等同 urlencoded
fetch('/api/save', {
method: 'POST',
body: new URLSearchParams(new FormData(form))
});
關鍵提醒:使用 FormData 時不要手動設定 Content-Type 標頭。multipart 需要在標頭裡帶上一段 boundary 分隔字串,而那是由瀏覽器依實際內容生成的。若你手寫 'Content-Type': 'multipart/form-data',反而會因為缺少 boundary 導致伺服器無法解析。
總結: traditional 表單提交時,enctype 是必要設定,有檔案就一定要 multipart;改用 fetch 之後,讓 FormData 自己決定編碼方式,干預越少越不容易出錯。