JavaScript使用Blob对象实现文件下载的操作示例

作者:半夏

时间:2026-10-23

浏览:313

本文详解如何利用JavaScript的Blob对象实现文件下载,重点解析在Post请求导出Excel时,axios的responseType需设为arraybuffer或blob以避免乱码。同时指出需关闭mockjs拦截,并提供了完整的Vue2+Webpack3环境下的代码实现与注意事项。

文章目录

本文通过具体实例,介绍如何在JavaScript中利用Blob对象完成文件下载操作,供读者参考学习。

Blob对象概述

  • 前言
  • 运行环境
  • 具体操作步骤
  • 总结

Blob是一种表示不可变原始数据的类文件对象,它并非JavaScript的原生数据类型。File对象继承自Blob,并在其基础上扩展,以支持对用户本地文件的访问与操作。

前言

近期在处理通过Post请求导出Excel的需求时,思路是利用Blob对象接收后台返回的输出流。具体做法是将响应数据以arraybuffer或blob格式接收,交由Blob处理,最后生成URL链接供浏览器执行下载。

运行环境

  1. Vue 2.x
  2. Webpack 3.x
  3. Axios

具体操作步骤


import axios from 'axios'
/**
* 从服务器下载excel
*/
function downloadExcel (settings) {
 const defaultOptions = {
  responseType: 'arraybuffer'
 }
 Object.assign(settings.options, defaultOptions)
 requestToResponse(settings).then(res => {
  const filename = decodeURI(res.headers['content-disposition'].split('filename=')[1])
  if ('download' in document.createElement('a')) {
   downloadFile(res.data, filename)
  } else {
   Message.error('浏览器不支持')
  }
 })
}
/**
* 发送http请求
* @param {Object} settings api参数
* @returns reponse
*/
function requestToResponse (settings) {
  const defaultParams = {
  timeout: 45000,
  headers: {
   'X-Requested-With': 'XMLHttpRequest',
   'Content-Type': 'application/json'
  },
  responseType: 'json',
  method: 'POST'
 }
 Object.assign(defaultParams, settings)
  return new Promise((resolve, reject) => {
  axios(defaultParams).then(res => {
   resolve(res)
  }).catch(err => {
   reject(err)
  })
 })
}
/**
* blob下载(兼容IE)
* @param {String} content 文件内容
* @param {String} filename 文件名
*/
function downloadFile (content, filename) {
 const blob = new Blob([content])
 // IE
 if (window.navigator && window.navigator.msSaveOrOpenBlob) {
  window.navigator.msSaveOrOpenBlob(blob, filename)
 } else {
  imatateDownloadByA(window.URL.createObjectURL(blob), filename)
 }
}
/**
* 通过a标签模拟下载
* @param {String} href
* @param {String} filename
*/
function imatateDownloadByA (href, filename) {
 const a = document.createElement('a')
 a.download = filename
 a.style.display = 'none'
 a.href = href
 document.body.appendChild(a)
 a.click()
 a.remove()
 window.URL.revokeObjectURL(href)
}

// 下载excel
downloadExcel({
  url: '/default/excel/export',
  responseType: 'arraybuffer'
})

首先,需将responseType设置为arraybuffer。 Blob对象概述 其次,也可将responseType设置为blob。 Blob对象概述 若未设置responseType,下载的文件内容会出现乱码。 Blob对象概述 此外,如果项目中引入了mockjs,其拦截响应并重置了responseType,同样会导致乱码问题。 Blob对象概述

总结

  1. 此种基于Blob的下载方式仅适用于Post请求,Get请求应交由浏览器自行解析处理。
  2. 务必将responseType设置为arraybuffer或blob。
  3. 在导出Excel时,必须关闭mockjs等拦截响应的服务,以免干扰响应类型。

感兴趣的朋友可以使用在线HTML/CSS/JavaScript代码运行工具:http://tools.jb51.net/code/HtmlJsRun测试上述代码运行效果。

更多关于JavaScript相关内容感兴趣的读者可查看本站专题:《javascript面向对象入门教程》、《JavaScript错误与调试技巧总结》、《JavaScript数据结构与算法技巧总结》、《JavaScript遍历算法与技巧总结》及《JavaScript数学运算用法总结》

希望本文所述对大家JavaScript程序设计有所帮助。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章