后端返回文件流前端(Vue)如何处理

日常前端开发中,下载文件有后端返回路径和返回流文件两种方式。本文主要分享后端返回流文件时前端的处理方法,请求流文件可能是post或get请求,post请求需在axios中设置响应类型为blob,还提到处理文件名及响应头的注意事项。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在我们日常开发中前端下载文件通常分为两种方式,一种为后端返回路径,前端直接拼接路径使用window.location.href下载。另一种是后端以流文件的方式返回给我们下载文件,今天主要分享当后端返回流文件时,前端如何处理。

首先,请求流文件的方法一般是post请求,但是也有是get请求,看和后端的约定,当为post请求时,我们在封装的axios请求方法中要设置请求响应类型为blob,为get请求时则不用设置,代码如下:

export function exportData(data) {
  return request({
    url: "/download/exportdataexcel",
    method: "post",
    responseType: "blob",
    data
  });
}

对流文件的处理代码:

exporSiteFile(fileId) {
			let params = {
				ProjectID: this.ProjectID,
				PCTime: new Date().getTime(),
				RequestType: "File",
				Condition: {
					Action: "SiteParamFile",
					Config: {
						FileID: fileId
					}
				}
			};
			exportData(params).then(res => {
				if (res.data.size > 0) {
					const blob = new Blob([res.data]);
					let url = window.URL.createObjectURL(blob); //根据返回的流文件创建url;url指向流
					let link = document.createElement("a");
					link.style.display = "none";
					link.href = url;
					let fileName = decodeURIComponent(res.headers["filename"]);
					link.setAttribute("download", fileName); // 自定义下载文件名(如exemple.txt)
					document.body.appendChild(link); //添加不可见a标签
					link.click(); //代码触发a标签的点击事件进行文件下载
				}
			});
		}

注:我这里使用的文件名为后端通过设置响应头返回对应文件名,当然也可以自定义文件名,当使用响应头获取文件名时要注意在封装的request.js中是否对响应结果进行的拦截把响应头对象给去掉了,如果去掉则要针对该响应头做出特殊处理。

### 实现后端返回文件流并在Vue.js中触发Excel文件下载 为了实现在 Vue.js处理来自后端文件流并触发 Excel 文件下载,可以按照如下方式操作: 在前端部分,当接收到后端发送过来的数据时,需创建一个 Blob 对象来保存这些数据。Blob 是一种表示不可变原始数据的类文件对象[^1]。 ```javascript axios({ method: 'get', url: '/api/excel', // 后端API地址 responseType: 'blob' // 显式指定响应类型为二进制大对象 }).then((response) => { const blob = new Blob([response.data], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=utf-8;' }); let linkElement = document.createElement('a'); try { const url = window.URL.createObjectURL(blob); linkElement.href = url; linkElement.download = decodeURI(response.headers['content-disposition'].split('filename=')[1]); // 获取文件名 document.body.appendChild(linkElement); // Firefox 需要这一步骤才能正常工作 linkElement.click(); setTimeout(() => { window.URL.revokeObjectURL(url); // 清除已使用的 URL 对象 document.body.removeChild(linkElement); // 移除临时创建的 a 标签 }, 0); } catch (error) { console.error(error.message || error); } }); ``` 此代码片段展示了如何通过 Axios 库发起请求,并设置 `responseType` 参数为 `'blob'` 来确保能够正确解析从服务器获得的内容作为二进制形式。一旦成功获取到响应体中的数据,则会将其转换成一个新的 Blob 实例;接着利用 `<a>` 元素模拟点击行为从而启动浏览器自带的文件保存对话框完成实际的文件下载过程[^2]。 另外,在某些情况下可能还需要注意跨域资源共享(CORS)配置问题。如果前后端不在同一个域名下部署的话,那么就需要确保服务端已经允许客户端访问特定头信息(比如 Content-Disposition),这样才能顺利拿到正确的文件名称等附加元数据[^3]。 对于可能出现错误的情况,如网络异常或是不兼容的操作环境等问题,应该加入适当的异常捕获机制以便及时反馈给用户具体的失败原因[^4]。 最后值得注意的是,不同版本或类型的浏览器可能会有不同的表现特性,因此建议测试阶段尽可能覆盖多种主流平台以验证功能的一致性和稳定性[^5]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值