适用场景: 很多时候,前端存在需要从后端下载文件的情况,典型的就是导出excel表格。
一般存在两种方式:
1,请求接口之后,后端返回文件路径,前端直接下载。
2,请求接口之后,后端以文件流的形式返回给前端,前端再下载到本地。
第一种方式:
很简单,请求完接口之后,打开该文件的地址:
window.location.href = res.request.responseURL responseURL这个地址其实和接口地址是一样,直接打开它,就能默认下载到本地的下载路径了。
非常方便,但是存在不足,比如不能修改文件的名称。
而且,有些场景使用这种方式是行不通的,比如,很多管理系统,都是需要登录的,既然要登录,那就一般都会需要验证每个请求是否安全,往往需要在header里带上token,后端才会给你这个请求放行。
所以,这种方式,你请求接口之后,转到这个链接,其实就是再请求了一次,这个时候你是不好在请求里带上token的,自然也就拿不到你要的文件。
所以,这个时候就要用第二种方式,以文件流的方式来下载。
第二种方式:
第二种方式,就是正常的api请求,后端以文件流的形式发送给前端,前端获取到文件数据之后,在本地模拟一次点击按钮下载,不过这次下载不是再向后端请求一次api,而是把第一次请求api之后,后端返回的文件数据转换成合适的格式之后下载下来
exportFile(this.queryParam).then(res => {
if (res.status === 200) {
const xlsx = 'application/vnd.ms-excel'
const blob = new Blob([res.data], { type: xlsx })
//转换数据类型
const a = document.createElement('a') // 转换完成,创建一个a标签用于下载
// const name = res.headers['content-disposition']
// a.download = name.split('=')[1]
a.download = `${this.$t('自定义文件名')}.xlsx`
a.href = window.URL.createObjectURL(blob)
a.click()
a.remove()
document.body.removeChild(a) //也可以这么移除
// 直接打开下载文件的链接
// window.location.href = res.request.responseURL
}
})
1.不管是第一种方式还是第二种方式,尽量让后端指定好文件的类型。当然,使用第二种方式,前端可以再次指定好文件类型。
2.这里将获取到的文件内容转换成blob类型的数据,是最常见的下载文件数据的格式,当然还可以使用别的方式。
3.这里创建a标签取下载文件,还可以用别的方式,或者如果碰到浏览器兼容性的问题,可能需要个性化处理。
4.download这里可以拿后端返回的文件名,也可以自己定义文件名,看你自己哪个方便一些。如果后端拿到的文件名是乱码,建议直接在前端定义文件名。
5.最关键的是,下载文件乱码的问题,很多人碰到,解决方法也很简单。
export function exportFile (parameter) {
return axios({
url: `${api.file}/export`,
method: 'get',
data: parameter,
header: {
headers: { 'Content-Type': 'application/x-download' }
},
responseType: 'blob'
})
}
在请求接口的header里一定要指定responseType为blob,否则把返回的文件数据转换成blob对象,blob是不认识的,就会出现乱码。
常见问题FAQ
- 免费下载或者VIP会员专享资源能否直接商用?
- 本站所有资源版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担。更多说明请参考 VIP介绍。
- 提示下载完但解压或打开不了?
- 找不到素材资源介绍文章里的示例图片?
- 模板不会安装或需要功能定制以及二次开发?
发表评论
还没有评论,快来抢沙发吧!