前端获取后端文件流下载excel,pdf,word等文件

今天工作碰到一个需求,点击按钮导出excel,后端是直接返回的文件流,如下图:


后端返回的文件流

方案一

直接用a标签来改造这个按钮,把下载地址放到href里,因为后端已经在响应头里设置了文件名和文件类型,点击按钮就能下载带有默认文件名的excel文件了。但是这个方案中,地址如果是动态的就不够灵活了。


响应头

方案二

按钮不变成a标签,在按钮的点击事件里处理

// 获取baseurl
click(){
    const baseurl= `xxx`;
    // 拼接上导出的地址,如果接口还需要其他参数,都可以直接拼接上
    let url=`${baseurl}/xxx/export/${xxx}`
    // 第二个参数'_self'表示在当前页下载,不打开新的页面
    window.open(url,'_self')
}

方案三

直接处理文件流

axios({
  method: '请求方法(get/post)',
  url: '地址',
  data: '请求参数',
  responseType: 'blob' // 响应数据的类型要设置成blob,设置arraybuffer也可以,下文有解释
}).then((res) => {
  // 解析文件名
  const str = res.headers['content-disposition'].split(';')[1].split('=')[1];
  const filename = decodeURIComponent(str);
  // 用blob存储二进制文件
  const blob = new Blob([res.data], {
    type: 'application/vnd.ms-excel', // 设置文件类型 pdf是application/pdf,word是application/vnd.openxmlformats-officedocument.wordprocessingml.document,其他类型可以百度一下
  });
  // 创建一个临时的url指向blob对象
  const objectUrl = window.URL.createObjectURL(blob);
  // 创建url之后可以模拟对此文件对象的一系列操作,例如:预览、下载
  const a = document.createElement('a');
  a.setAttribute('href', objectUrl);
  a.setAttribute('download', filename);
  a.click();
  // 5.释放这个临时的对象url
  window.URL.revokeObjectURL(objectUrl);
}).catch(error => {
  ...
});

Blob(Binary Large Object)是用于表示大型二进制数据对象的 JavaScript 数据类型。它是一个不可变的原始数据对象,可以存储各种类型的数据,如图像、音频、视频和其他任意二进制数据。
Blob 对象和 ArrayBuffer 对象在某些方面相似,因为它们都可以用来存储二进制数据。但是,它们之间也存在一些重要的区别。
数据存储形式:ArrayBuffer 是一个连续的、固定长度的原始二进制数据缓冲区。它是在内存中分配一块指定长度的空间来存储数据。而 Blob 是一个非连续的二进制数据对象,它可以由多个片段(即 Blob 的数据块)组成。这意味着 Blob 对象可以由不同的数据来源进行构建,例如从文件、网络请求或其他 Blob 对象中创建。
可访问性:ArrayBuffer 对象提供了一种机制,通过 TypedArray 和 DataView 视图来直接读取和修改数据。而 Blob 对象并不直接暴露数据的内容,而是提供了一组异步方法(例如 FileReader)来读取其中的数据。
用途和应用场景:ArrayBuffer 主要用于在 JavaScript 中高效地处理和操作二进制数据,例如图像处理、音频解码、加密算法等。而 Blob 对象更适合用于处理文件、上传下载、数据传输等场景,因为它可以方便地保存和传递整个数据块,而不需要直接读取或修改其内容。
总结一下,ArrayBuffer 和 Blob 都是用于处理二进制数据的 JavaScript 数据类型。ArrayBuffer 是一个连续的固定长度二进制数据缓冲区,而 Blob 是一个非连续的二进制数据对象,可以由多个片段组成。ArrayBuffer 提供了直接读取和修改数据的能力,而 Blob 则适用于处理文件、上传下载和数据传输等场景。根据具体的使用需求,选择使用适合的数据类型来操作和处理二进制数据。

补充

最近开发时,和新的后端同学联调时发现要么下载的文件打不开,要么下载的文件是空白,研究了一下发现是后端代码少配置了几个属性,Access-Control-Expose-Headers这个响应头的属性需要设置前端可见,Content-Type要设置成对应的文件类型,Content-Disposition数据处理方式和文件名也要处理一下。
下面代码是我用koa写的后端获取文件流示例代码,安装koa和koa2-cors的依赖后,把需要给前端的文件地址配置一下,就可以node index.js运行了,给前端的url就是http://localhost:3000

文件名:index.js
const Koa = require('koa');
const cors = require('koa2-cors');
const fs = require('fs');
const path = require('path');
const app = new Koa();

app.use(cors());

// 让Content-Disposition在前端可见,需要设置Access-Control-Expose-Headers
app.use(async (ctx, next) => {
  ctx.set('Access-Control-Expose-Headers', 'Content-Disposition');
  await next();
});

app.use(async ctx => {
    // 获取文件路径
    const filePath = path.join(__dirname, './jianli.pdf'); // 你的文件地址
    // 读取文件
    const file = fs.readFileSync(filePath);
    // 设置响应类型为pdf
    ctx.set('Content-Type', 'application/pdf');
    // 设置响应头,使其可以下载,你可以设置你想要的文件名
    ctx.set('Content-Disposition', 'attachment; filename=jianli.pdf');
    // 将文件内容赋值给response.body
    ctx.body = file;
});

app.listen(3000, () => {
    console.log('Server is running at http://localhost:3000');
});
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,530评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,403评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,120评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,770评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,758评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,649评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,021评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,675评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,931评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,410评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,004评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2 343

推荐阅读更多精彩内容