JS前端下载文本文件小技巧:1、download属性;2、借助Blob转换成二进制下载、及前端根据后端返回的文件流实现下载功能
一、HTML download 与文件下载
如果希望在前端侧直接触发某些资源的下载,最方便快捷的方法就是使用HTML5原生的download
属性,例如:
<a href="large.jpg" download>下载</a>
但显然,如果纯粹利用HTML属性来实现文件的下载(而不是浏览器打开或浏览),对于动态内容,就无能为力。
例如,我们对页面进行分享的时候,希望分享图片是页面内容的实时截图,此时,这个图片就是动态的,纯HTML显然是无法满足我们的需求的,借助JS和其它一些HTML5特性,例如,将页面元素转换到canvas
上,然后再转成图片进行下载。
是否支持download属性的监测:要监测当前浏览器是否支持download
属性,一行JS代码就可以了,如下:
var isSupportDownload = 'download' in document.createElement('a');
二、借助HTML5 Blob实现文本信息文件下载
原理其实很简单,我们可以将文本或者JS字符串信息借助Blob转换成二进制,然后,作为<a>
元素的href
属性,配合download
属性,实现下载。
代码也比较简单,如下示意(兼容Chrome和Firefox):
var funDownload = function (content, filename) {
// 创建隐藏的可下载链接
var eleLink = document.createElement('a');
eleLink.download = filename;
eleLink.style.display = 'none';
// 字符内容转变成blob地址
var blob = new Blob([content]);
eleLink.href = URL.createObjectURL(blob);
// 触发点击
document.body.appendChild(eleLink);
eleLink.click();
// 然后移除
document.body.removeChild(eleLink);
};
其中,content
指需要下载的文本或字符串内容,filename
指下载到系统中的文件名称。
触发下载的JS代码就几行:
button.addEventListener('click', function () {
funDownload(textarea.value, 'test.html');
});
不止是.html
文件,.txt
、 .json
等只要内容是文本的文件,都是可以利用这种小技巧实现下载的。
在Chrome浏览器下,模拟点击创建的<a>
元素即使不append
到页面中,也是可以触发下载的,但是在Firefox浏览器中却不行,因此,上面的funDownload()
方法有一个appendChild
和removeChild
的处理,就是为了兼容Firefox浏览器。
实例:
var eleTextarea = document.querySelector('textarea');
var eleButton = document.querySelector('input[type="button"]');
// 下载文件方法
var funDownload = function (content, filename) {
var eleLink = document.createElement('a');
eleLink.download = filename;
eleLink.style.display = 'none';
// 字符内容转变成blob地址
var blob = new Blob([content]);
eleLink.href = URL.createObjectURL(blob);
// 触发点击
document.body.appendChild(eleLink);
eleLink.click();
// 然后移除
document.body.removeChild(eleLink);
};
if ('download' in document.createElement('a')) {
// 作为test.html文件下载
eleButton.addEventListener('click', function () {
funDownload(eleTextarea.value, 'test.html');
});
} else {
eleButton.onclick = function () {
alert('浏览器不支持');
};
}
总结:
1、download属性下载文件:download="文件路径"
2、Blob二进制转换:new Blob([content]),以及二进制路径转换:URL.createObjectURL(new Blob([content]))
三、前端根据后端返回的文件流实现下载功能
上面是取网页内容,如果是后端返回的文件流的话,也可以这样实现下载。
1、起初我请求后台数据返回的是这个样子的,需要对此进行操作
2、最重要的是需要在请求上加下这样的响应类型:blob
headers: {
'Content-Type': 'application/json'
},
responseType: 'blob',
3、在需要下载的页面请求函数中
downloadFileApi(_params).then(res => {
let blob = res.data
let objectUrl = URL.createObjectURL(blob);
let a = document.createElement('a');
a.href = objectUrl;
a.download = '测试名字.xlsx';
// 触发点击
document.body.appendChild(a)
a.click()
document.body.removeChild(a)
})
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· SQL Server 2025 AI相关能力初探
· 震惊!C++程序真的从main开始吗?99%的程序员都答错了
· 单元测试从入门到精通
· 【硬核科普】Trae如何「偷看」你的代码?零基础破解AI编程运行原理
· 上周热点回顾(3.3-3.9)
· winform 绘制太阳,地球,月球 运作规律