当前位置:首页 > 技术 > 正文内容

前端通过文件流实现多格式文件下载指南

访客 技术 2026年5月29日 1

在Web开发中,经常需要根据后端接口返回的二进制文件流触发浏览器下载。以下是一个可复用的工具函数集合,支持导出Excel、Word、PDF、ZIP、N42、TXT、JSON等多种格式。

创建通用下载工具方法

在项目中新建一个工具文件(如downloadUtils.js),封装不同文件类型的下载逻辑:

// 通用下载方法(适用于Excel/Word/PDF/ZIP/N42)
function downLoadFile(data, fileName, mimeType) {
  const blob = new Blob([data], { type: mimeType });
  const url = URL.createObjectURL(blob);
  const anchor = document.createElement('a');
  anchor.href = url;
  anchor.download = fileName;
  document.body.appendChild(anchor);
  anchor.click();
  document.body.removeChild(anchor);
  URL.revokeObjectURL(url);
}

// Excel导出
export function exportExcel(data, fileName) {
  downLoadFile(data, fileName, 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=utf-8');
}

// Word导出
export function exportWord(data, fileName) {
  downLoadFile(data, fileName, 'application/msword');
}

// PDF导出
export function exportPdf(data, fileName) {
  downLoadFile(data, fileName, 'application/pdf');
}

// ZIP导出
export function exportZip(data, fileName) {
  downLoadFile(data, fileName, 'application/octet-stream');
}

// N42导出(基于XML格式)
export function exportN42(data, fileName) {
  downLoadFile(data, fileName, 'application/xml');
}

1. 导出Excel文件

调用通用方法,设置正确MIME类型:

import { exportExcel } from '@/utils/downloadUtils';

async function downloadExcel() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getExcelData(params);
  exportExcel(response.data, '报表数据.xlsx');
}

2. 导出Word文档

import { exportWord } from '@/utils/downloadUtils';

async function downloadWord() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getWordData(params);
  exportWord(response.data, '文档.doc');
}

3. 导出PDF文件

import { exportPdf } from '@/utils/downloadUtils';

async function downloadPdf() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getPdfData(params);
  exportPdf(response.data, '报告.pdf');
}

4. 导出ZIP压缩包

import { exportZip } from '@/utils/downloadUtils';

async function downloadZip() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getZipData(params);
  exportZip(response.data, '打包文件.zip');
}

5. 导出N42文件(核辐射检测数据格式)

import { exportN42 } from '@/utils/downloadUtils';

async function downloadN42() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getN42Data(params);
  exportN42(response.data, '测量数据.n42');
}

6. 导出TXT文本文件

推荐使用file-saver库简化操作:

npm install file-saver

import { saveAs } from 'file-saver';

async function downloadTxt() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getTextData(params);
  const blob = new Blob([response.data], { type: 'text/plain;charset=utf-8' });
  saveAs(blob, '日志文件.txt');
}

7. 导出JSON数据文件

import { saveAs } from 'file-saver';

async function downloadJson() {
  const params = { /* 接口参数 */ };
  const response = await ExportApi.getJsonData(params);
  const jsonStr = JSON.stringify(response.data, null, 2);
  const blob = new Blob([jsonStr], { type: 'application/json' });
  saveAs(blob, '配置数据.json');
}

以上方法涵盖了前端常见的文件流下载场景,适用于大多数后台管理系统中的数据导出需求。注意根据实际接口响应结构调整参数传递方式。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。