原生JS与Vue实现文件上传下载及常见问题处理

作者:小布丁时间:2026-10-24 03:14:28浏览:171

本文详细讲解如何使用原生JavaScript封装文件下载功能,重点处理Blob对象与兼容性点击事件。同时介绍基于Vue的文件上传实现,包括FormData构造、大小校验及接口调用。针对input file组件在选中同一文件时不触发change事件的常见Bug,提供了重置value值的解决方案。

原生JS文件下载功能实现

一、文件下载功能实现

首先需要编写核心下载代码。


const fileDownloadClick = (obj) => { // 解决兼容
 if( document.all ){
  obj.click();
 } else {
  let event = document.createEvent("MouseEvents");
  event.initEvent('click', true, true);
  obj.dispatchEvent(event);
 }
}
const fileDownload = (res,obj) => { // 下载
  /*
  obj :{
   userName  下载人
   weeklyTime 下载时间
   weeklyType 下载类型 
  }
 */ 
 let blob = new Blob([res]);
 let url = window.URL.createObjectURL(blob);
 let link = document.createElement('a');
 link.style.display = 'none';
 link.href = url;
 link.setAttribute('download', `${obj.userName || ' '}_${obj.weeklyTime || dateFormatYMD(new Date())}_${obj.weeklyType || '.xlsx' }`);
 document.body.appendChild(link);
 // link.click();
 fileDownloadClick(link);
 window.URL.revokeObjectURL(url);
}

在发起网络请求时,必须配置响应类型为 ,以确保后端返回的文件流数据能被正确解析为二进制对象。


responseType: 'blob',

调用该方法时,参数 代表后台返回的文件流数据(通常表现为乱码字符串), 为期望保存的文件名。


res: 后台返回的文件流( 类似于乱码的东西 )
obj:下载文件名称

//页面中调用
this.fileDownload = (res,obj)

Vue环境下的文件上传与问题处理

二、文件上传功能实现(基于Vue框架)

在Vue页面中,通常通过隐藏的文件输入框触发上传逻辑。


<input type="file" ref="upload" @change='handleUploadChange($event)' style="display:none;">



 handleUploadFile(row){ // 通过某一事件触发 
  this.$refs['upload'].click();
 },
 
 

  async handleUploadChange(e){ // 
   try{
    let res = await this.CommonUpload(e);
    if(res.code == '200'){ // 获取其他code值,根据后台来定
      this.handleProjectAddFile(res.data)
    }else{}
   }
    catch(err){}
  }

封装上传方法时,主要进行文件大小校验,也可通过 accept 属性限制接收的文件类型。


CommonUpload(e){ 
    const files = e.target.files;
    let formData = new FormData();
    if(files && files[0]) {
      const file = files[0];
      if(file.size > 1024 * 1024 *3) {
        alert('文件大小不能超过3M');
        return;
      } else {
        formData.append("multipartFile", file); 
      }
    }
    this.uploadFile_(formData) // 为调用上传接口方法
  }

常见问题:当用户再次选择与之前相同的文件时,上传操作可能失效。


解决: ( 上传后执行下面 )
this.$refs['upload'].value = ''; // 解决 input file 第二次失效的问题

原因:
input file value值为新选中的值,所以下次再选同一文件,不会触发change事件

以上介绍了文件上传与下载的核心知识点及常见问题的解决方法,如有其他疑问欢迎交流。

作者最新文章