vue实现文件流形式的导出下载全过程

 更新时间:2025年12月16日 16:40:30   作者:yx_back  
Vue项目中下载返回的文件流操作包括:使用Axios请求文件流数据、设置响应类型为'blob'、创建下载链接并触发下载,关键步骤是使用Blob对象和URL.createObjectURL生成下载链接

Vue项目中下载返回的文件流操作步骤

1、使用 Axios 请求文件流数据;

2、设置响应类型为 ‘blob’;

3、创建下载链接并触发下载。

其中,最关键的一步是创建一个 Blob 对象并使用 URL.createObjectURL 方法生成一个下载链接。

以下将详细说明如何实现。

一、使用 Axios 请求文件流数据

在 Vue 项目中,需要使用 Axios 来发送请求并获取文件流数据。

可以在组件中使用 Axios 进行 HTTP 请求,确保在请求头中设置适当的响应类型。

import axios from 'axios';

export default {
  methods: {
    downloadFile() {
      axios({
        method: 'get',
        url: 'your-file-endpoint',  // 替换为实际的文件流接口
        params:{},
        responseType: 'blob'
      })
      .then(response => {
        this.handleFileDownload(response.data);
      })
      .catch(error => {
        console.error('Error downloading the file', error);
      });
    }
  }
};

二、设置响应类型为 ‘blob’

在 Axios 请求中,设置 responseType 为 ‘blob’,这样 Axios 会将响应数据处理为 Blob 对象。

Blob 对象表示一个不可变的、原始数据的类文件对象。

三、创建下载链接并触发下载

为了触发文件下载,需要创建一个 URL 链接并模拟点击事件。

可以在组件中添加一个方法来处理 Blob 数据并进行下载。

methods: {
	  /**
	 * 拿到文件流后的下载的方法
	 * @param {*} data
	 * @param {*} filename
	 * @param {*} mime
	 * @param {*} bom
	 */
	 function downloadByData(data: BlobPart, filename: string, mime?: string, bom?: BlobPart) {
	  const blobData = typeof bom !== 'undefined' ? [bom, data] : [data];
	  const blob = new Blob(blobData, { type: mime || 'application/octet-stream' });
	  if (typeof window.navigator.msSaveBlob !== 'undefined') {
	    window.navigator.msSaveBlob(blob, filename);
	  } else {
	    const blobURL = window.URL.createObjectURL(blob);
	    const tempLink = document.createElement('a');
	    tempLink.style.display = 'none';
	    tempLink.href = blobURL;
	    tempLink.setAttribute('download', filename);
	    if (typeof tempLink.download === 'undefined') {
	      tempLink.setAttribute('target', '_blank');
	    }
	    document.body.appendChild(tempLink);
	    tempLink.click();
	    // 移除 a 标签
	    document.body.removeChild(tempLink);   
	     // 释放 URL 对象
	    window.URL.revokeObjectURL(blobURL);
	  }
	}
}

四、在 Vue 组件中集成下载功能

<template>
  <div>
    <button @click="downloadFile">Download File</button>
  </div>
</template>
<script lang="ts" setup>

  // 下载
async function downloadFile() {
    try {
       axios({
        method: 'get',
        url: 'your-file-endpoint',  // 替换为实际的文件流接口
        params: {},   // 请求参数
        responseType: 'blob'
    }).then(
        (response) => {
          console.log('downloadByData',response)
          if(response.headers['content-disposition']) {
            let fileName = response.headers['content-disposition'].split('filename=')[1];
            // console.log('filename',fileName)
            fileName = fileName.replace(/"/g, '');
            downloadByData(response.data,fileName)
          } else {
            downloadByData(response.data,'xiazai.xlsx')
          }          
        }
      )
    } catch (e) {
      console.log(e);
    }
  }
  
  
  /**
 * 拿到文件流后的下载的方法
 * @param {*} data
 * @param {*} filename
 * @param {*} mime
 * @param {*} bom
 */
 function downloadByData(data: BlobPart, filename: string, mime?: string, bom?: BlobPart) {
  const blobData = typeof bom !== 'undefined' ? [bom, data] : [data];
  const blob = new Blob(blobData, { type: mime || 'application/octet-stream' });
  if (typeof window.navigator.msSaveBlob !== 'undefined') {
    window.navigator.msSaveBlob(blob, filename);
  } else {
    const blobURL = window.URL.createObjectURL(blob);
    const tempLink = document.createElement('a');
    tempLink.style.display = 'none';
    tempLink.href = blobURL;
    tempLink.setAttribute('download', filename);
    if (typeof tempLink.download === 'undefined') {
      tempLink.setAttribute('target', '_blank');
    }
    document.body.appendChild(tempLink);
    tempLink.click();
    document.body.removeChild(tempLink);
    window.URL.revokeObjectURL(blobURL);
  }
}


</script>

五、解释与实例说明

1、使用 Axios 请求文件流数据

Axios 是一个基于 Promise 的 HTTP 客户端,可以用于浏览器和 Node.js。

在发送请求时,通过设置 responseType 为 ‘blob’ 来确保返回的数据是二进制流格式。

2、设置响应类型为‘blob’

Blob 对象表示一个不可变的、原始数据的类文件对象,可以表示数据,比如二进制数据。

在请求中指定 responseType 为 ‘blob’,可以确保 Axios 将响应数据处理为 Blob 对象。

3、创建下载链接并触发下载

Blob 对象可以通过 URL.createObjectURL 方法生成一个临时的 URL,用于表示该 Blob 对象。

创建一个 a 标签,并设置其 href 属性为生成的 URL,download 属性为文件名。

通过 JavaScript 触发点击事件来启动下载,然后移除 a 标签并释放生成的 URL。

4、下载文件,文件名获取不到

二进制流下载文件,从response header里面获取文件名,后端也设置了header【Content-Disposition】的值为【attachment;filename=MY_DOCUMENT_23.pdf】

network查看请求,response header的确是有值,但是axios获取header的值,永远只有content-type

这个请求是跨域请求

服务端加一个额外的响应头

【Access-Control-Expose-Headers】值为【Content-Disposition】

设置了这个响应头后,axios就可以获取到content-disposition响应头,也就能够拿到这个附件名字

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Vue 组件间的样式冲突污染

    Vue 组件间的样式冲突污染

    本篇文章主要介绍了Vue 组件间的样式冲突污染,当多个样式出现时,就会导致样式冲突,本文介绍了具体解决方法
    2017-08-08
  • Vue3中Composition API的原理与实战指南

    Vue3中Composition API的原理与实战指南

    Composition API为开发者提供了一种全新的组织组件逻辑的方式,本文将深入探讨Vue3中Composition API的实际应用,帮助开发者掌握这一强大工具
    2025-07-07
  • 项目中一键添加husky实现详解

    项目中一键添加husky实现详解

    这篇文章主要为大家介绍了项目中一键添加husky实现示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • Vue3组件更新中的DOM diff算法示例详解

    Vue3组件更新中的DOM diff算法示例详解

    虚拟dom是当前前端最流行的两个框架(vue和react)都用到的一种技术,都说他能帮助vue和react提升渲染性能,提升用户体验,下面这篇文章主要给大家介绍了关于Vue3组件更新中的DOM diff算法的相关资料,需要的朋友可以参考下
    2022-04-04
  • 一篇带你搞懂Vue中的自定义指令

    一篇带你搞懂Vue中的自定义指令

    自定义指令,是Vue提供的一种扩展和定制的机制,使开发者能够在组件中直接操作DOM、处理事件、添加样式等,并提供了与第三方库集成的方式,定义指令使得Vue在处理交互和DOM操作时更加灵活和强大,本文将带大家搞懂Vue中的自定义指令,需要的朋友可以参考下
    2023-07-07
  • vue在body和query中如何向后端传参

    vue在body和query中如何向后端传参

    这篇文章主要介绍了vue在body和query中如何向后端传参,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-09-09
  • Vue使用预渲染代替SSR的方法

    Vue使用预渲染代替SSR的方法

    这篇文章主要介绍了Vue使用预渲染代替SSR的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-07-07
  • Vue3动态引入图片全过程

    Vue3动态引入图片全过程

    在Vite项目中,动态引入background-image需使用import或newURL方法,避免打包路径问题,静态资源存放在src/assets,建议使用绝对路径/开头确保正确引用
    2025-08-08
  • elementui的table根据是否符合需求合并列的实现代码

    elementui的table根据是否符合需求合并列的实现代码

    这篇文章主要介绍了elementui的table根据是否符合需求合并列的实现代码,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2024-03-03
  • vue给对象动态添加属性和值的实例

    vue给对象动态添加属性和值的实例

    今天小编就为大家分享一篇vue给对象动态添加属性和值的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-09-09

最新评论