axios设置responseType为blob或arraybuffer时正确处理返回值的方案

作者:清欢时间:2026-10-26 09:17:16浏览:101

本文详解在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(默认类型)
arraybufferArrayBuffer对象
blobBlob对象
documentDocumnet对象
jsonJavaScript object, parsed from a JSON string returned by the server
textDOMString

关于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下载返回值的内容,请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!

作者最新文章