当后端要求使用 FormData
传参时,前端需要将数据格式化为 FormData
对象,并通过 POST
请求发送。以下是处理 FormData
传参的详细步骤和示例代码:
FormData
是一种用于构造表单数据的对象,通常用于上传文件或发送键值对数据。它支持文本、文件、Blob 等多种数据类型。
使用 new FormData()
创建一个空的 FormData
对象。
使用 append
方法将数据添加到 FormData
对象中。
将 FormData
对象作为请求体发送到后端。
假设后端需要接收 username
和 password
两个字段:
// 创建 FormData 对象
const formData = new FormData();
// 添加数据
formData.append('username', 'admin');
formData.append('password', '123456');
// 发送请求
fetch('/api/login', {
method: 'POST',
body: formData, // 将 FormData 作为请求体
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
假设后端需要接收一个文件(如用户头像):
<input type="file" id="avatar" />
<button onclick="uploadFile()">上传文件button>
<script>
function uploadFile() {
const fileInput = document.getElementById('avatar');
const file = fileInput.files[0]; // 获取用户选择的文件
if (!file) {
alert('请选择一个文件');
return;
}
// 创建 FormData 对象
const formData = new FormData();
formData.append('file', file); // 添加文件到 FormData
// 发送请求
fetch('/api/upload', {
method: 'POST',
body: formData, // 将 FormData 作为请求体
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
}
script>
假设后端需要接收 username
和 avatar
(用户头像文件):
<input type="text" id="username" placeholder="用户名" />
<input type="file" id="avatar" />
<button onclick="submitForm()">提交button>
<script>
function submitForm() {
const username = document.getElementById('username').value;
const fileInput = document.getElementById('avatar');
const file = fileInput.files[0]; // 获取用户选择的文件
if (!username || !file) {
alert('请填写用户名并选择文件');
return;
}
// 创建 FormData 对象
const formData = new FormData();
formData.append('username', username); // 添加文本数据
formData.append('avatar', file); // 添加文件数据
// 发送请求
fetch('/api/submit', {
method: 'POST',
body: formData, // 将 FormData 作为请求体
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
}
script>
请求头:
FormData
时,浏览器会自动设置 Content-Type
为 multipart/form-data
,因此不需要手动设置。Content-Type
,可能会导致请求失败。文件大小限制:
兼容性:
FormData
在现代浏览器中支持良好,但在一些旧版浏览器(如 IE 10 以下)中可能不支持。如果需要兼容旧版浏览器,可以使用 XMLHttpRequest
代替 fetch
。如果你使用 axios
发送请求,可以这样处理:
const formData = new FormData();
formData.append('username', 'admin');
formData.append('avatar', file); // 假设 file 是用户选择的文件
axios.post('/api/submit', formData, {
headers: {
'Content-Type': 'multipart/form-data', // axios 会自动处理,这里可以省略
},
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));
如果你想查看 FormData
的内容,可以使用以下方法:
for (let [key, value] of formData.entries()) {
console.log(key, value);
}
后端接收 FormData
的方式取决于使用的框架:
multer
或 formidable
中间件。request.files
和 request.form
。@RequestParam
或 MultipartFile
。通过以上方法,你可以轻松处理前端使用 FormData
传参的需求。如果有更复杂的需求(如多文件上传、分片上传等),可以进一步扩展实现。。