singleDownloadFile 下载单个文件

function singleDownloadFile(source: string, fileName?: string, pathQuery?: Record<string, string>): Promise<void>

下载单个文件。source 支持 Base64 字符串或 HTTP/HTTPS URL；不同来源会使用不同下载策略。

参数

参数名	说明	类型	默认值
source	下载源，支持 Base64 字符串或 URL	string	必填
fileName	保存文件名；Base64 下载时必填	string	undefined
pathQuery	文件 URL 下载时追加的查询参数	Record<string, string>	{ 'response-content-type': 'application/octet-stream' }

返回值

返回值	说明	类型
promise	下载触发完成后 resolve 的 Promise	Promise<void>

示例

import { singleDownloadFile } from '@mingto/tools'

await singleDownloadFile('https://example.com/report.pdf')

await singleDownloadFile('SGVsbG8=', 'hello.txt')

await singleDownloadFile('https://example.com/report.pdf', 'custom.pdf', {
  token: 'abc',
})

注意事项

• Base64 下载未传 fileName 时会抛出错误。
• 有效文件 URL 会通过 axios 请求 Blob 后使用 file-saver 保存。
• 非文件路径 URL 会创建隐藏 <a> 标签并触发点击。