这里介绍两种方法,使用 Blob 对象 和 使用 js-file-download
这两种方法下载的文件都 不会乱码 ,但是 不管使用哪种方法,发送请求时都要设置 responseType
如果不打算了解直接使用,请通过目录或者直接点击跳转 四、主要完整代码
方法一:使用 Blob 对象
Blob 对象表示一个不可变、原始数据的类文件对象。Blob 表示的不一定是 JavaScript 原生格式的数据。File 接口基于 Blob,继承了 blob 的功能并将其扩展使其支持用户系统上的文件。
一、Blob()
构造函数
摘自:Blob()
构造函数
语法
var aBlob = new Blob(array, options);
参数
-
array 是一个由
ArrayBuffer
,ArrayBufferView
,Blob
,DOMString
等对象构成的Array
,或者其他类似对象的混合体,它将会被放进Blob
。DOMStrings 会被编码为 UTF-8。 -
options 是可选的,它可能会指定如下两个属性:
-
type
,默认值为""
,它代表了将会被放入到 blob 中的数组内容的 MIME 类型。也就是设置文件类型。 -
endings
,默认值为"transparent"
,用于指定包含行结束符\n
的字符串如何被写入。它是以下两个值中的一个:"native"
,代表行结束符会被更改为适合宿主操作系统文件系统的换行符,或者"transparent"
,代表会保持 blob 中保存的结束符不变。
-
二、URL 对象
通过创建 URL 对象指定文件的下载链接。
// 创建新的 URL 表示指定的 File 对象或者 Blob 对象。let objectURL = window.URL.createObjectURL(blob);
window.URL.revokeObjectURL(objectURL); // 释放内存
在每次调用 createObjectURL()方法时,都会创建一个新的 URL 对象,即使你已经用相同的对象作为参数创建过。当不再需要这些 URL 对象时,每个对象必须通过调用 URL.revokeObjectURL()方法来释放。浏览器会在文档退出的时候自动释放它们,但是为了获得最佳性能和内存使用状况,你应该在安全的时机主动释放掉它们。
三、利用 a 标签自定义文件名
const link = document.createElement('a'); // 生成一个 a 标签。link.href = window.URL.createObjectURL(blob); // href 属性指定下载链接
link.download = fileName; // dowload 属性指定文件名
link.click(); // click()事件触发下载
download 属性设置文件名时,可以直接设置扩展名。如果没有设置,则浏览器将自动检测正确的文件扩展名并添加到文件。
四:主要完整代码
-
普通下载
axios.post(postUrl, params, {responseType: 'arraybuffer'}).then(res => { // 创建 Blob 对象,设置文件类型 let blob = new Blob([res.data], {type: "application/vnd.ms-excel"}) let objectUrl = URL.createObjectURL(blob) // 创建 URL location.href = objectUrl; URL.revokeObjectURL(objectUrl); // 释放内存 })
-
自定义下载后的文件名
// 利用 a 标签自定义下载文件名 const link = document.createElement('a') axios.post(postUrl, params, {responseType: 'arraybuffer'}).then(res => { // 创建 Blob 对象,设置文件类型 let blob = new Blob([res.data], {type: "application/vnd.ms-excel"}) let objectUrl = URL.createObjectURL(blob) // 创建 URL link.href = objectUrl link.download = 'xxx' // 自定义文件名 link.click() // 下载文件 URL.revokeObjectURL(objectUrl); // 释放内存 })
注:下载指定扩展名的文件只需要对照 MIME 参考手册设置 type 即可。
方法二:使用 js-file-download
-
安装
npm install js-file-download --save
-
使用
import fileDownload from 'js-file-download' axios.post(postUrl, params, {responseType: 'arraybuffer'}).then(res => {fileDownload(res.data, 'xxx.xls') })