Axios 怎么通过 FormData 对象上传文件

FormData 对象介绍

FormData 是一个用于在客户端创建表单数据的接口。它可以通过 JavaScript 中的 new FormData() 构造函数创建。FormData 可以将表单字段的键值对以键值对的方式添加,同时也支持添加文件。

在文件上传的场景中,我们可以使用 FormData 对象来收集表单数据,包括文件和其他文本字段,然后将其发送到后端服务器。

FormData 对象用于将数据编译成键值对,以便将其提交到服务器,它主要用于通过 XHR 传输文件。

使用 FormData 的主要优点:

  • 可以异步上传文件
  • 可以上传二进制文件
  • 提交表单时自动处理表单数据编码
  • 可以上传文件流(Blob 对象和 File 对象)

Axios 通过 FormData 上传文件

Axios 可以通过 FormData 对象上传文件,主要有两种方法:

1. 直接在 FormData 中追加文件

直接将文件对象作为 value,追加到 FormData 中,axios 会自动对文件进行编码。

复制代码
const formData = new FormData();

formData.append('file', fileInput.files[0]); // fileInput 为 <input type="file" />

axios.post('/upload', formData) 

2. 设置 request header 的 Content-Typ

Axios 默认发送 JSON 数据,设置 headers 将 Content-Type 设置为 multipart/form-data 后,就会处理为 FormData 对象提交。

复制代码
const formData = new FormData();

formData.append('file', fileInput.files[0]);

axios.post('/upload', formData, {
  headers: {
    'Content-Type': 'multipart/form-data'
  }
})

实践案例

为演示文件上传过程,本文将使用 Node.js 构建后端服务器。后端会提供 /upload 接口来处理文件上传请求。

1.首先,创建前端 HTML 页面,本文以 index.html 为例:

复制代码
<!DOCTYPE html>
<html>
<head>
  <title>文件上传示例</title>
</head>
<body>
  <input type="file" id="fileInput">
  <button onclick="uploadFile()">上传文件</button>

  <script src="axios.min.js"></script>
  <script src="main.js"></script>
</body>
</html>

2.然后,创建前端 JavaScript 文件 main.js,用于实现文件上传的交互逻辑:

复制代码
function uploadFile() {
  const fileInput = document.querySelector('#fileInput');
  const file = fileInput.files[0];

  // 使用FormData对象上传文件
  const formData = new FormData();
  formData.append('file', file);

  axios.post('http://localhost:5500/upload', formData, {
    headers: {
      'Content-Type': 'multipart/form-data'
    }
  }).then(response => {
    console.log('上传成功', response.data);
  }).catch(error => {
    console.error('上传失败', error);
  });
}

3.最后,创建 Node.js 后端服务器脚本(可命名为 server.js,用于接收并处理文件上传请求:

复制代码
const express = require("express");
const multer = require("multer");
const cors = require("cors"); // 引入cors中间件
const app = express();
const upload = multer({ dest: "uploads/" });

// 使用cors中间件来设置CORS
app.use(cors());

app.post("/upload", upload.single("file"), (req, res) => {
  const file = req.file;
  console.log("已接收到文件", file);
  // 在此处进行文件保存或其他处理
  res.send({
    code: 200,
    data: "文件上传成功",
  });
});

app.listen(5500, () => {
  console.log("服务器已启动,监听端口 5500");
});

当然,为使后端服务器正常运行,还需要安装以下 Node.js 扩展模块:

  • express - 构建 Web 应用框架
  • multer - 用于处理 multipart/form-data 类型的表单数据,从而实现文件上传功能
  • cors - 用于实现跨域资源共享,解决前后端跨域问题安装命令如下:
复制代码
  npm install express

  npm install multer

  npm install cors
相关推荐
柳杉20 分钟前
震惊!字符串还能这么玩!
前端·javascript
不怕犯错,就怕不做44 分钟前
linux 如何查看自己的帐号密码及samba的帐号和密码
linux·运维·服务器
是上好佳佳佳呀1 小时前
【前端(五)】CSS 知识梳理:浮动与定位
前端·css
仍然.1 小时前
算法题目---模拟
java·javascript·算法
wefly20171 小时前
纯前端架构深度解析:jsontop.cn,JSON 格式化与全栈开发效率平台
java·前端·python·架构·正则表达式·json·php
李彦亮老师(本人)2 小时前
Rocky Linux 9.x 新特性详解
linux·运维·服务器·centos·rocky linux
NiKick2 小时前
在Linux系统上使用nmcli命令配置各种网络(有线、无线、vlan、vxlan、路由、网桥等)
linux·服务器·网络
我命由我123453 小时前
React - 类组件 setState 的 2 种写法、LazyLoad、useState
前端·javascript·react.js·html·ecmascript·html5·js
聊聊MES那点事3 小时前
JavaScript图表控件AG Charts使用教程:使用AG Charts React实时更新柱状图
开发语言·javascript·react.js·图表控件
zt1985q3 小时前
本地部署开源元搜索引擎 SearXNG 并实现外部访问
服务器·网络协议·开源