本文详解在axios请求中设置responseType为blob或arraybuffer时,如何正确处理后端返回的二进制流与JSON错误对象。通过TextDecoder将arraybuffer转回JSON判断状态,以及利用FileReader读取blob数据,实现文件下载与异常提示的兼容处理。
问题背景
在前端开发中,调用后台接口获取图片时,后端通常返回二进制流格式的图片数据。前端接收到该数据流后,需要对其进行特定处理,以便在img标签中正常显示图片内容。
解决方案概述
处理二进制数据主要涉及两个步骤:首先配置axios以接收特定格式的数据,其次将接收到的数据转换为前端可用的格式。
responseType: 'arraybuffer'
2、转换为base64格式图片数据在img标签显示:使用64位编码
return 'data:image/png;base64,' + btoa(
new Uint8Array(res.data).reduce((data, byte) => data + String.fromCharCode(byte), '')
);
第二步,将接收到的arraybuffer数据转换为base64格式的图片数据,从而在img标签中直接显示。
若直接将返回的string赋值给img标签的src属性,图片即可直接显示。
axios.post( ExportUrl, Params, {
responseType: 'blob'
})
.then(function(response) {
this.url = window.URL.createObjectURL(new Blob([response.data]));
});
另一种常见场景是设置axios接收参数格式为blob,这通常用于处理文件下载请求。
const url = '下载的url链接';
const link = document.createElement('a');
link.href = url;
link.target = '_blank';
link.setAttribute('download', 'Excel名字.xlsx');
document.body.appendChild(link);
link.click();
通过创建a标签并设置download属性,可以实现文件的直接下载功能。
| 值 | 数据类型 |
|---|---|
| ‘’ | DOMString(默认类型) |
| arraybuffer | ArrayBuffer对象 |
| blob | Blob对象 |
| document | Documnet对象 |
| json | JavaScript object, parsed from a JSON string returned by the server |
| text | DOMString |
关于responseType的值类型说明
axios的responseType属性支持多种数据类型,具体包括:DOMString(默认类型)、arraybuffer(ArrayBuffer对象)、blob(Blob对象)、document(Document对象)、json(由服务器返回的JSON字符串解析成的JavaScript对象)以及text(DOMString)。
针对不同返回值情况的处理示例如下:
当请求设置为responseType: 'arraybuffer'时,若请求成功,后端返回文件流,前端可正常导出文件;
若请求失败,后端可能返回JSON对象,例如:{"Status":"false","StatusCode":"500","Result":"操作失败"},此时该JSON数据也会被转换为arraybuffer格式。
值得注意的是,无论请求成功还是失败,后端返回的HTTP状态码通常都是200。
针对上述情况,解决方案是将已转换为arraybuffer类型的数据重新转回JSON对象,进而进行业务逻辑判断。
具体实现代码如下:
async downloadFile (file) {
let res = await this.$axios.post(this.API.order.tradeImpExcle, { responseType: "arraybuffer" });
if (!res) return;
try {
//如果JSON.parse(enc.decode(new Uint8Array(res.data)))不报错,说明后台返回的是json对象,则弹框提示
//如果JSON.parse(enc.decode(new Uint8Array(res.data)))报错,说明返回的是文件流,进入catch,下载文件
let enc = new TextDecoder('utf-8')
res = JSON.parse(enc.decode(new Uint8Array(res.data))) //转化成json对象
if (res.Status == "true") {
this.refresh()
this.$message.success(res.Msg)
} else {
this.$message.error(res.Result)
}
} catch (err) {
const content = res.data;
const blob = new Blob([content]);
let url = window.URL.createObjectURL(blob);
let link = document.createElement("a");
link.style.display = "none";
link.href = url;
link.setAttribute(
"download",
res.headers["content-disposition"].split("=")[1]
);
document.body.appendChild(link);
link.click();
}
}
当请求设置为responseType: 'blob'时,
解决方案是将已转换为blob类型的数据转回JSON对象,然后进行相应的判断处理。
具体实现代码如下:
async downloadFile (file) {
let formData = new FormData();
formData.append("allTradesExcelFile", file);
let res = await this.$axios.post(this.API.order.tradeImpExcle, formData, { responseType: "blob" });
if (!res) return;
let r = new FileReader()
let _this = this
r.onload = function () {
try {
// 如果JSON.parse(this.result)不报错,说明this.result是json对象,则弹框提示
// 如果JSON.parse(this.result)报错,说明返回的是文件流,进入catch,下载文件
res = JSON.parse(this.result)
if (res.Status == "true") {
_this.refresh()
_this.$message.success(res.Msg)
} else {
_this.$message.error(res.Result)
}
} catch (err) {
const content = res.data;
const blob = new Blob([content]);
let url = window.URL.createObjectURL(blob);
let link = document.createElement("a");
link.style.display = "none";
link.href = url;
link.setAttribute(
"download",
res.headers["content-disposition"].split("=")[1]
);
document.body.appendChild(link);
link.click();
}
}
r.readAsText(res.data) // FileReader的API
}
总结
本文介绍了在axios请求中设置responseType为'blob'或'arraybuffer'时,如何正确处理返回值的详细方案。更多相关axios请求设置responseType下载返回值的内容,请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!