JS 下载/导出 csv、excel、txt 、img等文件的方法总结
1. 调用后端接口导出文件
示例下载接口url https://gold-cdn.xitu.io/extension/0.3.9/package.crx
1.1 window.open(url)
会打开一个新窗口,开始下载后会自动关闭新窗口。Safair 下载后没有关闭新窗口。
Chrome、IE、Safair支持,貌似火狐不支持
1.2 window.location=url
在当前窗口下载
Chrome、Safair支持
1.3 iframe
function downloadByIframe (url) { try { const iframe = document.createElement('iframe'); iframe.src = url; iframe.style.display = 'none'; document.body.appendChild(iframe); } catch (e) { }}下载在HTML中,iframe 的属性用src,但在JS中,只有部份浏览器支持修改src(读是没问题),真正通用的是要修改对应框架的href值。
function changeIframeSrc (url) { window.iframes['myIframe'].location.href = url;}1.4 点击链接下载
function downloadByAElement (url, fileName) { try { const element = document.createElement('a'); element.href = url; element.download = fileName; const a = document.body.appendChild(element); a.click(); document.body.removeChild(element); } catch (e) { }}downloadByAElement ('https://gold-cdn.xitu.io/extension/0.3.9/package.crx', 'test');HTML5中给a标签增加了一个download属性,只要有这个属性,点击这个链接时浏览器就不在打开链接指向的文件,而是改为下载,目前只有chrome、firefox、opera、Edge支持。常用此方法点击下载图片。
IE既不支持a标签的download属性也不允许js调用a 标签的click方法。
2. 前端直接导出文件到本地
2.1 将数据转成DataURI用标签下载
点击链接下载
function saveData2File (data, fileName) { try { const element = document.createElement('a'); cosnt uri = getDownloadUri(data); element.href = uri; element.download = fileName; const a = document.body.appendChild(element); cosnt evt = document.createEvent('HTMLEvents'); evt.initEvent('click', false, false); // 不加后面两个参数在Firefox上报错 a.dispatchEvent(evt); document.body.removeChild(element); } catch (e) { }}注意: 浏览器对href属性的URL长度有限制,若超过浏览器自身限制的最大长度会导致下载失败。

Data URI Scheme
Data URI Scheme是指可以在Web 页面中包含图片但无需任何额外的HTTP 请求的一类URI。 Data URI Scheme一般用于将经过base64编码的数据嵌入网页中,从而减少请求资源的链接数。IE8 之前的版本都不支持 data URI scheme。
DataURI的格式:
data: [][;charset=][;],- data: 协议名称
- [] 可选项,数据类型,常用的有 image/png, image/svg+xml, text/plain
- [;charset=] 可选项,源文本的字符集编码方式。[][;charset=] 的缺省值为HTTP Header 中Content-Type的字段值;
- [;] 数据编码方式(有US-ASCII,BASE64 两种),默认值为US-ASCII,就是每个字符会编码为%xx的形式
- , 编码后的数据, 如果 不是以 [;] 方式编码的数据,则会报异常
生成DataURI的方式
1. encodeURIComponent
function getDownloadUri (data) { const mimeType = 'attachment/csv'; const charset = ';charset=utf-8,'; const _utf = ''; // 为了使文件以utf-8的编码模式,同时也是解决中文乱码的问题 return 'data:' + mimeType + charset + _utf + encodeURIComponent(data)}使用这种方式,当数据过多时,URI长度容易超出浏览器限制。 encodeURIComponent常用来转码接口参数,为了避免服务器收到不可预知的请求,对任何用户输入的作为URI部分的内容都需要用encodeURIComponent进行转义。
2. URL.createObjectURL
URL.createObjectURL的参数是File对象或者Blob对象
- File对象也就是通过input[type=file]选择的文件
- Blob对象表示一个不可变、原始数据的类文件对象
IE10以下不支持URL.createObjectURL
function getDownloadUri (data) { const _utf = ''; // 为了使文件以utf-8的编码模式,同时也是解决中文乱码的问题 if (window.Blob && window.URL && window.URL.createObjectURL) { const blob = new Blob([_utf + data], { type: 'text/json' // 写自己需要的数据格式 }); return URL.createObjectURL(blob); }}2.2 windows.navigator.msSaveBlob IE10~Edge 专用
msSaveBlob 是IE10~Edge 私有方法。
function downloadByMsSaveBlob (data) { const _utf = ''; var blob = new Blob([_utf + data], { type: 'text/json' // 自己需要的数据格式 }); navigator.msSaveBlob(_csvData, fileName); }2.3 execCommand
当一个HTML文档切换到设计模式时,document暴露 execCommand 方法,该方法允许运行命令来操纵可编辑内容区域的元素。
有的资料有提到IE9可以使用execCommand方法来保存数据到本地文件,但是我自己没有验证过,不知道是否可行。而且MDN文档中execCommand没有查到SaveAs命令。这块只是做个小记录。
function saveFileByExecCommand (data, fileName) { const newWindow = window.top.open('about:blank', '_blank'); newWindow.document.write('sep=,' + data); newWindow.document.close(); newWindow.document.execCommand('SaveAs', false, fileName); newWindow.close();}js数据直接导出/下载数据到本地到方法总结
function saveData2File (data, fileName) { const bw = getBrowser(); // 获取浏览器信息 if (!bw['edge'] || !bw['ie']) { const element = document.createElement('a'); cosnt uri = getDownloadUri(data); element.href = uri; element.download = fileName; const a = document.body.appendChild(element); cosnt evt = document.createEvent('HTMLEvents'); evt.initEvent('click', false, false); // 不加后面两个参数在Firefox上报错 a.dispatchEvent(evt); document.body.removeChild(element); } else if (bw['ie'] >= 10 || bw['edge'] === 'edge') { const blob = createBlob(data); navigator.msSaveBlob(blob, fileName); }}function getBrowser () { const sys = {}; const ua = navigator.userAgent.toLowerCase(); if (ua.indexOf('edge') !== -1) { sys.edge = 'edge'; } else if (ua.match(/rv:([d.]+)) like gecko/)) { sys.ie = ua.match(/rv:([d.]+)) like gecko/)[1]; } else if (ua.match(/msie ([d.]+)/)) { sys.ie = ua.match(/msie ([d.]+)/)[1]; } else if (ua.match(/firefox/([d.]+)/)) { sys.firefox = ua.match(/firefox/([d.]+)/)[1]; } else if (ua.match(/chrome/([d.]+)/)) { sys.chrome = ua.match(/chrome/([d.]+)/)[1]; } else if (ua.match(/opera.([d.]+)/)) { sys.opera = ua.match(/opera.([d.]+)/)[1]; } else if (ua.match(/version/([d.]+).*safari/)) { sys.safari = ua.match(/version/([d.]+).*safari/)[1]; } return sys; }本文转载自:https://juejin.im/post/5cd00253518825418f6f2a8c?utm_source=gold_browser_extension
这篇博客总结了JS下载csv、excel、txt、img等文件的方法,包括调用后端接口、DataURI Scheme、createObjectURL、navigator.msSaveBlob等,同时提到了不同浏览器的兼容性和限制。
791

被折叠的 条评论
为什么被折叠?



