后端返回二进制流,前端进行下载时,一般需要转成blob(Binary large Object),然后再进行下载。
blob构造函数语法:
代码语言:javascript复制var blob = new Blob(blobParts, options);
- blobParts:它是一个由 ArrayBuffer,ArrayBufferView,Blob,DOMString 等对象构成的数组,或者其他类似对象的混合体。DOMStrings 会被编码为 UTF-8
- options:一个可选的对象,包含以下两个属性:
- type —— 默认值为 "",它代表了将会被放入到 blob 中的数组内容的 MIME 类型。
- endings —— 默认值为 "transparent",用于指定包含行结束符 n 的字符串如何被写入。 它是以下两个值中的一个: "native",代表行结束符会被更改为适合宿主操作系统文件系统的换行符,或者 "transparent",代表会保持 blob中保存的结束符不变。
(该选项博主理解不深,有了解的小伙伴可评论区留言)
设置MIME类型
代码语言:javascript复制const mimeMap = {
xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
zip: 'application/zip'
}
设置环境BASE_API
代码语言:javascript复制const baseUrl = process.env.VUE_APP_BASE_API
请求下载
- 设置responseType:blob;
- 如需要设置token,在请求头加上{ 'Authorization': 'Bearer ' getToken() };
- 从response的headers中获取filename, 后端需在response.setHeader("Content-disposition", "attachment; filename=xxxx.docx") 设置的件名。
export function downLoadZip(str, filename, data, type) {
var url = baseUrl str
request(url, filename, data, 'zip')
}
export function downloadXlsx(str, filename, data) {
var url = baseUrl str
request(url, filename, data, 'xlsx')
}
function request(url, filename, data, type) {
axios({
method: 'post',
url: url,
responseType: 'blob',
data: data,
headers: { 'Authorization': 'Bearer ' getToken() }
}).then(res => {
resolveBlob(res, mimeMap[type])
})
}
/**
- 解析blob响应内容并下载
- @param {*} res blob响应内容
- @param {String} mimeType MIME类型
*/
export function resolveBlob(res, mimeType) {
const aLink = document.createElement('a')
var blob = new Blob([res.data], { type: mimeType })
var patt = new RegExp('filename=([^;] \.[^\.;] );*')
var contentDisposition = decodeURI(res.headers['content-disposition'])
var result = patt.exec(contentDisposition)
var fileName = result[1]
fileName = fileName.replace(/"/g, '')
aLink.href = URL.createObjectURL(blob)
aLink.setAttribute('download', fileName) // 设置下载文件名称
document.body.appendChild(aLink)
aLink.click()
document.body.appendChild(aLink)
}
可能出现的问题
- 不设置responseType:blob,文件会下载,但是打不开;文件不能下载,报code:500
- MIME类型设置错误,打开xlsx文件出现Object Object或者undefined undefined
- res.data打印值
- res.header打印值
- new RegExp().exec() exec()接受一个参数,即要应用模式的字符串,然后返回包含第一个匹配项信息的数组;或者在没有匹配项的情况下返回null。 返回的数组是Array实例,但包含两个额外的属性: index 和 input
- index 表示匹配项在字符串中的位置;
- index 表示匹配项在字符串中的位置。
补充:
前端axios设置了responseType:blob时,接收到数据就是blob,但是当文件导出失败时,返回的类型是json(为什么是json,后端异常处理一般都是response.setContentType("application/json");throw error;),此时是无法正常解析的,此时要通过json转换的形式进行解析。
代码语言:javascript复制if(data.type=="application/json"){
const reader=new fileReader();
reader.onload=function(){
const {msg}= JSON.parse(reader.result);
//处理错误
this.$message.error(msg)
};
reader.readAsText(data);
}else{
//按上面正常的来
}
另一种写法
代码语言:javascript复制const reader = new fileReader();
reader.onload=function(){
try(){
//如果JSON.parse(reader.result)不报错,则返回的是json,否则返回的是二进制流,进入catch,下载文件
if(JSON.parse(reader.result)){
const {msg}= JSON.parse(reader.result);
//处理错误
this.$message.error(msg)
}
}catch(err){
//下载文件
}
};
我正在参与2023腾讯技术创作特训营第三期有奖征文,组队打卡瓜分大奖!