通过JS创建FormData实现上传多张图片

Posted 2022-01-08 webchang

通过form表单是前端向后端发送数据的一种方式，另外，我们也可以通过JS手动的创建FormData来发送数据。基础部分跳过，这里展示一个我在使用FormData的过程中踩的坑。

FormData学习资料

目标：向后端发送一段文本和图片（单张或多张）。

先来看一下使用form表单的形式：

<form
  action="http://192.168.171.144/api/xxx"
  method="post"
  enctype="multipart/form-data">
  内容content:<input name="content" type="text" />
  图片images:<input name="images" multiple="multiple" type="file" />
  <input type="submit" value="提交" />
</form>

这种方式比较简单，对于单张或多张图片都能处理。

---

再来看一下使用FormData的形式：

内容content：<input type="text" id="contentInput" /> 
图片images：<input type="file" id="fileInput" multiple />
<button onclick="submit()" id="btn">上传</button>

<script src="https://cdn.bootcdn.net/ajax/libs/axios/0.21.1/axios.js"></script>
<script>
  const contentInput = document.getElementById("contentInput");
  const fileInput = document.getElementById("fileInput");

  function submit() 
    const files = fileInput.files;
    const content = contentInput.value;
    // 创建FormData
    const formData = new FormData();
    formData.append("content", content);
    // 注意这里是单张图片，只要了第一张
    formData.append("images", files[0]);
    axios(
      url: "http://192.168.171.144/api/xxx",
      method: "post",
      data: formData,
    )
      .then(res => 
        console.log(res);
      )
      .catch(err => 
        console.log(err);
      );
  
</script>

使用formData处理单张图片可以上传成功，并且能在请求中看到formData的数据。如果是多张图片呢？应该怎么传？

下面这种方式是不对的。

const files = fileInput.files;
const formData = new FormData();
// files是FileList对象，直接这样传是不对的，这里也是我踩坑的地方
formData.append("images", files);

如果要传多张图片，需要将这些图片对象的file对象一个个加入formData中，键名相同，都是images。

const files = fileInput.files;
const formData = new FormData();
// 处理多张图片
for (let i = 0; i < files.length; i++) 
  formData.append("images", files[i]);

这样就可以上传成功了。

前端学习交流QQ群 862748629，群内学习讨论的氛围很好，大佬云集。点我加入