FormData 是二进制兼容的提交载体,不直接生成查询字符串;需用 URLSearchParams 转换才能得到标准 key=value&... 格式,且天然支持多选、正确处理空值与未选中控件。

直接用 FormData 就行,但得清楚它不等于“字符串序列化”——它本身是二进制兼容的传输载体,真要转成 key=value&... 查询字符串,得过一道 URLSearchParams。
FormData 本身不输出字符串,它是个可提交对象
FormData 的设计目标是原生支持文件 + 文本混合提交,所以它内部不强制编码为 URL 字符串格式。调用 formData.toString() 会返回 [object FormData],毫无意义。
- 它适合直接传给
fetch()或XMLHttpRequest.send(),此时浏览器自动设置Content-Type: multipart/form-data(含文件)或application/x-www-form-urlencoded(纯文本,取决于是否有文件) - 如果表单里有
<input type="file">,FormData是唯一能正确携带二进制内容的方式 - 没有文件时,
FormData仍会按规范编码值(比如空格变+,中文变%E4%BD%A0),但你拿不到原始字符串
想得到标准查询字符串?用 URLSearchParams 转一下
这是最干净、兼容性够用(Chrome 49+、Firefox 44+、Safari 10.1+)的做法:
const form = document.getElementById('myForm');
const formData = new FormData(form);
const searchParams = new URLSearchParams(formData);
console.log(searchParams.toString()); // → "username=john&age=25&hobby=%E7%AF%AE%E7%90%83"
-
URLSearchParams构造函数接受FormData实例,自动遍历所有键值对并做encodeURIComponent - 对多选
<select multiple></select>或多个同名checkbox,它天然生成多个hobby=篮球&hobby=足球,符合服务器端接收习惯 - 注意:如果某个字段值是
null或undefined,FormData会把它转成空字符串,URLSearchParams也会照常编码 —— 这和 jQuery 的.serialize()行为一致,但不同于手动遍历时的if (field.value)判断
radio/checkbox 未选中时不会出现在 FormData 里
这是规范行为,不是 bug。HTML 表单的“成功控件”定义明确:radio 和 checkbox 只有在 checked 为 true 时才被收集。
立即学习“前端免费学习笔记(深入)”;
- 如果你需要“未选中也传 false”,不能依赖
FormData原生逻辑,得自己补全 - 常见做法:先获取所有
name属性相同的input[type=radio]元素,检查是否至少一个被选中;没选中就手动append(name, 'false') - 或者换思路:后端约定“缺失即 false”,前端完全不传 —— 更轻量,也更符合 RESTful 风格
不要用 jQuery serialize() 除非项目已重度依赖它
$('form').serialize() 确实方便,但它有硬伤:
- 不处理
disabled字段的逻辑和原生不一致(有些版本会忽略,有些会包含) - 对
type="number"或type="date"输入框,可能拿到空字符串而非实际 value(取决于用户是否真的输入过) - 无法处理文件,遇到
<input type="file">直接跳过,静默丢弃 - IE 11 及更老环境才需要它;现代项目用原生 API 更可控、无额外包体积
真正容易被忽略的是:FormData 构造时只读取当前 DOM 状态,如果表单字段是动态渲染或 JS 修改了 value 但没触发 input 事件,它照样取到最新值 —— 这点比靠事件监听的手动序列化更可靠。



















