kongdeqiang
2026-10-12 285bf234bd50ce54fcae7bb777f8fa579b91266e
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
/**
 * 浏览器端文件下载。
 *
 * 为什么要走 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)
}