FormData不能直接转JSON,因含文件、重复键等;Object.fromEntries仅适用于纯文本无重复的极简场景,实际会丢失文件内容、覆盖同名值、兼容性差;应手动遍历并区分File与字符串类型处理。

FormData 不能直接转成 JSON 对象,因为它的键值对可能含二进制文件、重复键、空值,且原生不支持 JSON.stringify —— 直接 Object.fromEntries(new FormData(form)) 只在简单表单下“看似有效”,但一遇到 file 输入或同名多选框就出错。
为什么 Object.fromEntries(new FormData(form)) 不可靠
这个写法只适合纯文本字段、无重复 name、无文件的极简场景。实际中常见问题包括:
-
File对象被转成[object File]字符串,丢失内容和类型 - 多个同名
<input type="checkbox" name="tag">只保留最后一个值(FormData内部是追加逻辑,但fromEntries覆盖键) - 空字符串值(如未填的
textarea)可能被忽略或变成undefined - IE 和旧版 Safari 不支持
FormData.entries(),导致运行时报TypeError: Illegal invocation
安全转 JSON 的推荐做法:手动遍历 + 类型判断
用 formData.forEach() 或 for (const [key, value] of formData) 遍历,显式处理每种值类型。核心逻辑是区分 value 是 string 还是 File,并为同名字段聚合数组。
function formDataToJSON(formData) {
const result = {};
for (const [key, value] of formData) {
if (value instanceof File) {
// 文件保留原始 File 对象(后续上传用),或仅记录文件名/大小
if (!result[key]) result[key] = [];
result[key].push({
name: value.name,
size: value.size,
type: value.type,
});
} else {
// 普通字段:同名合并为数组,否则直接赋值
if (result[key] === undefined) {
result[key] = value;
} else if (Array.isArray(result[key])) {
result[key].push(value);
} else {
result[key] = [result[key], value];
}
}
}
return result;
}
调用:const json = formDataToJSON(new FormData(document.querySelector('form')));
立即学习“前端免费学习笔记(深入)”;
如果只是想发请求,别转 JSON —— 直接用 FormData 发送
多数后端(如 Express、Django、Spring)原生支持 multipart/form-data 解析。强行转 JSON 反而丢文件、增复杂度。
- 上传文件 + 文本字段 → 用
fetch(url, { method: 'POST', body: formData }),服务端收req.files和req.body - 纯文本表单 → 若后端要求 JSON,再用上面函数转;但更推荐服务端适配
application/x-www-form-urlencoded(new URLSearchParams(formData)更轻量) - 需要预览数据(比如调试)→ 转 JSON 时务必加
File判断,否则控制台看到的只是[object Object]
真正容易被忽略的是:表单里一个 <input type="file" multiple> 会一次性 append 多个 File 到同一个 key 下,但 formData.get(key) 只返回第一个 —— 必须用 formData.getAll(key) 才能取全。这点在封装通用转换函数时,几乎没人检查。



















