/**
|
* 浏览器端文件下载。
|
*
|
* 为什么要走 Blob + 临时 <a> 而不是直接 `location.href = url`:
|
* 导出接口需要 `Authorization` 头,而浏览器直接跳转是发不出自定义头的,
|
* 结果就是一个 401 的空白页。所以必须先由 axios 带 token 取回字节,
|
* 再在内存里造一个对象 URL 交给浏览器保存。
|
*/
|
|
/**
|
* 从 Content-Disposition 响应头解析服务端建议的文件名。
|
*
|
* 服务端按 RFC 5987 同时给了两个:
|
* attachment; filename="export.pdf"; filename*=UTF-8''%E4%B8%AD%E6%96%87.pdf
|
* 中文名只能从 filename* 里取(filename 那个是 ASCII 兜底)。
|
*
|
* @returns {string|null} 解析不出来时返回 null,由调用方用默认名兜底
|
*/
|
export function filenameFromDisposition(disposition) {
|
if (!disposition) return null
|
|
// 优先 filename*(带字符集与百分号编码)
|
const star = /filename\*\s*=\s*([^;]+)/i.exec(disposition)
|
if (star) {
|
let value = star[1].trim().replace(/^["']|["']$/g, '')
|
const parts = value.split("''")
|
if (parts.length === 2) {
|
value = parts[1]
|
}
|
try {
|
return decodeURIComponent(value)
|
} catch {
|
// 编码异常时退回下面的普通 filename
|
}
|
}
|
|
const plain = /filename\s*=\s*"?([^";]+)"?/i.exec(disposition)
|
if (plain) {
|
return plain[1].trim()
|
}
|
return null
|
}
|
|
/**
|
* 触发浏览器保存一个 Blob。
|
*
|
* 必须 revokeObjectURL:不释放的话,每下载一次就在内存里留一份
|
* 完整文件的副本,直到页面关闭 —— 下载几个大 PDF 就会明显吃内存。
|
*/
|
export function saveBlob(blob, filename) {
|
const url = URL.createObjectURL(blob)
|
const a = document.createElement('a')
|
a.href = url
|
a.download = filename || 'download'
|
a.style.display = 'none'
|
document.body.appendChild(a)
|
a.click()
|
document.body.removeChild(a)
|
|
// 交给浏览器一点时间开始下载,再释放
|
setTimeout(() => URL.revokeObjectURL(url), 1000)
|
}
|