前端实现将二进制文件流，并下载为excel文件_前端二进制流转文件

一、关于二进制流

• 含义：二进制流是一种计算机文件格式，它的数据以二进制形式存储，与文本文件不同。

二进制文件可以包含任意类型的数据，例如：图像、音频、视频、可执行文件、压缩文件等，而文本文件则仅仅包含 ASCII 码或其他编码的字符数据。

• 常见的： Blob、ArrayBuffer、File、FileReader 和 FormData

• 在浏览器中的样子如下：
  

二、项目实践

1、导入excel方法代码片段

// 导入时，接口调用，失败后得到文件流
axios(url, {
	method: 'post',
	responseType: 'blob',
	url: '/api/import',
  	data: formData, // 导入文件一般都用FormData 格式数据
}).then(res => {
  if(res.code === 200) {
    // 导入成功
  } else {
    // 导入失败，需要将返回的文件流res.data进行转换
    this.downloadBinaryFile(res.data, '导入失败后下载的报错文件')
  }
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14

2、二进制文件流转换成excel方法实现

/**
 * 将二进制文件下载到本地，保存为excel文件
 * @param {*} binFile 二进制文件流
 * @param {*} fileName 下载后的文件名
 * @param {*} blobType 文件格式
 */
downloadBinaryFile(binFile, fileName, blobType="application/vnd.ms-excel") {
	const blobObj = new Blob([binFile], { type: blobType });
	const downloadLink = document.createElement('a');
	let url = window.URL || window.webkitURL || window.moxURL; // 浏览器兼容
	url = url.createObjectURL(blobObj);
	downloadLink.href = url;
	downloadLink.download = fileName;
	document.body.appendChild(downloadLink);
	downloadLink.click();
	document.body.removeChild(downloadLink);
	window.URL.revokeObjectURL(url);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

参数说明：

• blobType 指的是服务端返回的Content-Type中mine-type，常用的excel类型一般有2种："application/vnd.ms-excel" 或 "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
  例如：
  

三、常见问题及解决

问题：成功将文件流转换成了excel文件，并下载了，但是下载后的文件打不了！

原因：就是在上传文件调用服务端接口时，axios请求缺少：responseType: 'blob'， 这个很重要！

responseType 表示服务器响应的数据类型，可以是 'arraybuffer', 'blob', 'document', 'json', 'text', 'stream'等

• arraybuffer：设置响应类型为二进制对象（返回的是一个包含二进制数据的 JavaScript ArrayBuffer 类型化数组）。

• blob：设置响应类型为二进制对象（返回的是一个包含二进制数据的 Blob 对象)。

• document: 设置响应类型为html document 或 xml document，具体根据接收到的数据的 MIME 类型而定。

• json: 设置响应类型为json类型，日常开发中常用。

• text：设置响应类型为text文本类型