前端jsvue下载后台传过来的流文件如excel并设置下载文件名

81次阅读

共计 2009 个字符,预计需要花费 6 分钟才能阅读完成。

这里介绍两种方法,使用 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')
    })

正文完
 0