问小白 wenxiaobai
资讯
历史
科技
环境与自然
成长
游戏
财经
文学与艺术
美食
健康
家居
文化
情感
汽车
三农
军事
旅行
运动
教育
生活
星座命理

Web文件上传完全指南:表单与JS异步请求实现

创作时间:
2025-01-22 02:37:35
作者:
@小白创作中心

Web文件上传完全指南:表单与JS异步请求实现

在Web开发中,文件上传是一个常见的需求。无论是使用ElementUI还是Antd等UI框架,都提供了现成的上传组件。但是,你是否真正理解文件上传的原理呢?本文将通过一个简单的示例,带你深入理解文件上传的两种主要方式:通过form表单和通过JavaScript发送异步请求。

上传文件的两种方式

上传文件主要有两种方式:

  1. 通过form表单
  2. 通过JavaScript发送异步请求

其中,JavaScript发送异步请求的方式,实际上是模拟了form表单提交的过程。

通过表单上传文件

首先,我们定义一个表单,method为post,action是上传文件的接口地址。此外,我们还有两个input,一个是选择上传文件用的,type为file,还有一个是普通的input。最后我们还有一个提交的按钮。

<form 
  method="post" 
  enctype="multipart/form-data"
  action="https://run.mocky.io/v3/435e224c-44fb-4773-9faf-380c5e6a2188"
>
  <input type="file" name="uploadFile" />
  <input type="text" name="userName" />
  <button type="submit">提交</button>
</form>

现在我们开始上传一个叫做woshitupian.png的图片:

两点注意事项

这里有两点需要特别注意。

首先,当我们上传文件的时候,和普通的表单提交有所不一样。我们除了将一些信息以字符串的形式传给接口之外,还传递了文件信息,这些文件信息是以二进制的格式进行传递的。

普通的表单提交,信息以字符串的形式提交给接口:

<form 
  method="post" 
  action="https://run.mocky.io/v3/435e224c-44fb-4773-9faf-380c5e6a2188"
>
  <input type="text" name="userName" />
  <input type="text" name="city" />
  <button type="submit">提交</button>
</form>

填写内容:

提交给接口的参数:

而上传文件的时候,我们选择上传一张名为woshitupian.png的图片,并在普通输入框填写100:

提交给接口的参数:

第二点注意事项来了!在

元素上,有一个enctype属性,这个属性的默认值是application/x-www-form-urlencoded。而当我们上传文件的时候,这个属性的值应该设置为multipart/form-data,否则传递给接口的参数会缺失上传文件的文件信息。

代码:

<form 
  method="post" 
  action="https://run.mocky.io/v3/435e224c-44fb-4773-9faf-380c5e6a2188"
>
  <input type="file" name="uploadFile" />
  <input type="text" name="userName" />
  <button type="submit">提交</button>
</form>

传递给接口的参数:

通过JS发送异步请求

使用form表单上传文件的时候有一个问题,就是页面会进行跳转,会离开我们当前的页面。而使用JavaScript发送异步请求的方式,可以完美解决这个问题。

当我们选择完一个文件,我们就可以发送一个POST请求,也就是在input[type="file"]的change事件的时候。同时,我们注意到,form表单提交其实就是发送了一个POST请求。而我们使用JavaScript发送POST请求,其实就是模拟了form表单发送一个POST请求。

最后一个小细节,我们给元素设置的enctype属性,其实最后在发送POST请求的时候,会被设置到Content-Type这个请求头中:

明确了上面的几点之后,我们的JavaScript发送异步请求的代码也就呼之欲出了:

<template>
  <form 
    method="post" 
    enctype="multipart/form-data"
    action="https://run.mocky.io/v3/435e224c-44fb-4773-9faf-380c5e6a2188"
  >
    <!-- 选择文件之后,执行 onFileChange 函数 -->
    <input type="file" name="uploadFile" @change="onFileChange" />
    <input type="text" name="userName" />
    <button type="submit">提交</button>
  </form>
</template>
<script setup>
import axios from 'axios'
// 选择文件之后,执行 onFileChange 函数 
function onFileChange(e) {
  // 获取到 type="file" 的 input 元素
  const target = e.target
  // 获取上传的文件
  const files = target.files
  // 如果文件存在
  if (files) {
    // 获取到上传的文件
    const uploadFile = files[0]
    console.log('uploadFile', uploadFile);
    // 定义 form data,form data 的数据结构和我们使用 form 表单提交时的数据结构一致
    const formData = new FormData()
    // 添加 uploadFile 字段,值为我们上传的文件的二进制数据
    formData.append('uploadFile', uploadFile)
    // 发送 POST 请求
    axios.post('https://run.mocky.io/v3/435e224c-44fb-4773-9faf-380c5e6a2188', formData, {
      headers: {
        // 设置 Content-Type 为 multipart/form-data 的请求头
        'Content-Type': 'multipart/form-data'
      }
    }).then(res => {
      console.log(res)
    })
  }
}
</script>

检查一下我们之前说的几点细节:

总结

到这里,恭喜你已经掌握了文件上传的基本原理,并且对其中的各种小细节也有了认识,比如:

  • 上传的图片以二进制格式传递
  • multipart/form-data请求头

本文原文来自CSDN

© 2023 北京元石科技有限公司 ◎ 京公网安备 11010802042949号