当前位置：首页 > article >正文

Vue.js组件开发-实现后端返回二进制文件在浏览器自动下载

article 2025/1/18 14:45:15

在Vue.js组件开发中，若需实现从后端获取二进制文件并触发浏览器自动下载，可以利用axios（或其他HTTP客户端库）来向后端发送请求，随后利用Blob对象及URL.createObjectURL方法生成一个可供下载的链接，最后通过创建一个隐藏的<a>元素或利用window.location来启动下载。

步骤

‌1.发送请求获取二进制数据‌：

利用axios向后端API发送请求，并指定responseType为blob以获取二进制数据。

2‌.创建Blob对象‌：

接收到的二进制数据将作为Blob对象返回，可用它来生成文件。

3‌.生成下载链接‌：

借助URL.createObjectURL方法，为Blob对象创建一个临时的URL。

4‌.触发下载‌：

通过创建一个隐藏的<a>元素，设置其href属性为上述临时URL，并调用click方法以启动下载。或者，也可以直接将window.location指向该URL来下载文件，但这种方法可能无法设置文件名。

‌5.清理工作‌：

下载完成后，应调用URL.revokeObjectURL来释放之前创建的临时URL，避免内存泄漏。

示例

<template>
  <div>
    <button @click="downloadFile">点击下载文件</button>
  </div>
</template>

<script>
import axios from 'axios';

export default {
  methods: {
    async downloadFile() {
      try {
        // 向后端发送请求以获取二进制文件数据
        const response = await axios.get('你的后端API地址', {
          responseType: 'blob' // 关键：指定返回类型为blob
        });

        // 从响应中提取Blob对象
        const blob = response.data;

        // 为Blob对象创建一个临时的下载URL
        const downloadUrl = URL.createObjectURL(blob);

        // 创建一个隐藏的<a>元素并触发下载
        const a = document.createElement('a');
        a.href = downloadUrl;
        // 可根据需要设置下载文件的名称
        a.download = '你的文件名.ext'; 
        document.body.appendChild(a);
        a.click();

        // 清理工作：从DOM中移除<a>元素，并释放临时URL
        document.body.removeChild(a);
        URL.revokeObjectURL(downloadUrl);
      } catch (error) {
        console.error('文件下载失败:', error);
      }
    }
  }
};
</script>