vue 中从后端获取到文件的 url 地址,前端根据 url 地址下载文件

vue 之从后端获取到文件的 url 地址,前端根据 url 地址文件下载

前言

项目用的是 vben admin 框架,用的是 vue3 + TS
项目需求数据导出功能,前端需要实现文件下载功能
后端返回的是文件的 url 地址 (本项目中返回的是阿里云 oss 的文件地址)

一、实现思路

从后端得到的是一个 url 地址,先通过 fetch api 请求这个 url 地址并转换成 blob 对象,通过 URL.createObjectUrl() 将 blob 对象生成 url 地址,绑定到

<a >

标签 的 href 属性上面,结合 download 来实现点击

<a >

标签下载文件

二、具体实现

1.完整代码

代码如下：

functionexportData(){let data =getForm().getFieldsValue();exportTowerHistoryToExcel({ deviceId,createTime: data.startTime }).then((url)=>{downLoadFile(url);});}functiondownLoadFile(url){let fileName = url.slice(url.lastIndexOf('/')+1);// 这里是通过从后端获取到的 url  地址中截出来原本的文件名fetch(url).then((res)=> res.blob()).then((blob)=>{const link = document.createElement('a');
          link.href =URL.createObjectURL(blob);// 下载文件的名称及文件类型后缀
          link.download = fileName;
          document.body.appendChild(link);
          link.click();//在资源下载完成后 清除 占用的缓存资源
          window.URL.revokeObjectURL(link.href);
          document.body.removeChild(link);});}

2.代码分析

2.1 通过 fetch 将 url 地址转换为 blob 对象

以下图片来自w3cschool文档 fetch_api

分析

res.blob() 的返回值是什么
从文档中我们知道res.blob() 返回的并不是一个 blob 对象,而是一个 Promise,继续 .then 获取到的才是 blob 对象

res.blob() 到底做了什么
每调用一次 res.blob() 都会执行

consume budy

的动作
执行流程大概是这个样子 : 获取字节流的读取器 --> 通过读取器来读取到所有的数据 --> 将数据包装成 blob 对象并返回

2.2 通过 URL.createObjectUrl() 将 blob 对象生成 url 地址

以下图片来自MDN文档 URL.createObjectURL()

分析

URL.createObjURL() 做了什么
我们在调用 URL.createObjURL() 的时候传递的参数是一个 blob 对象,每次调用 URL.createObjURL() 的时候,都会创建一个新的 URL 对象
注意 : 即使是用同一个 blob 对象 , 每次调用 URL.createObjURL() 都会生成不同的 URL 对象

生成的的 URL 对象什么时候会被释放
浏览器在 docoment 卸载的时候,会自动释放
为了获得最佳性能和内存使用状况,应当在不需要使用这些 URL 对象的安全的实际,主动释放掉他们

怎么释放生成的的 URL 对象
通过调用

URL.removeObjectURL(需要释放的URL )

可以来释放生成的 URL 对象

2.3 创建

<a>

标签元素,将该元素放到页面当中,并通过点击事件来实现下载功能

<ahref="xxxxx"><ahref="xxxxx"download="xxxx">

href：文件的绝对/相对地址
download: 文件名（可省略，省略后浏览器自动识别源文件名 , 但是有可能导致自动识别源文件名的时候没有文件后缀,导致文件没有格式）

const link = document.createElement('a');
          link.href =URL.createObjectURL(blob);// 下载文件的名称及文件类型后缀
          link.download = fileName;// 这里 download 可以不写
          document.body.appendChild(link);
          link.click();

总结

其实找到这个解决方案的时候直接拿来用挺顺利的,但是一开始并不明白它是怎么工作的,甚至每行都没太明白它为什么这么做,在整理下来的过程中,反而理解了一些东西,与君共勉~