/** * 浏览器端文件下载。 * * 为什么要走 Blob + 临时 而不是直接 `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) }