express实现文件下载

发表于 更新于 本文字数： 2.3k 阅读时长 ≈ 4 分钟
本文是作者对express实现文件下载的介绍，包括express实现文件下载的优势、实现细节、相关资料等，这些步骤可以帮助作者提高express实现文件下载的效率。

查看expressAPI，
对于文件下载，最简单的实现下载方法为如下

1
2
3
4
5
6
7
8
9
res.download('/report-12345.pdf', 'report.pdf', function(err){
  if (err) {
    // Handle error, but keep in mind the response may be partially-sent
    // so check res.headersSent
  } else {
    // decrement a download credit, etc.
  }
});

但是这种方法在实际使用中，发现了问题，那就是苹果safari浏览器在下载时候，文件标题会自动截取一段，或者乱码，或者问号，
一开始表示不解，IE都没事，利用fiddler进行抓包分析，发现res头部信息不对劲儿，存在两个filename，也就是不同浏览器对于重复filename处理，不一样，或者说safari对于重复filename会有问题，也就是res.download的写法毕竟是高度封装的，
换句话说，不要用这种高度封装的写法就好了，那么如何解决呢。
如下一种写法，这种没有高度封装，自己去写返回头部信息，经测试Safari下载果然没问题了。

1
2
3
4
5
6
7
8
let filename = "你好，地球人你好，地球人你好，地球人你好，地球人.pdf";
let filePath = path.resolve(__dirname, '..') + '/static/pdf/test.pdf';
let mimetype = mime.lookup(filePath);
res.setHeader('Content-Disposition', 'attachment; filename=' + new Buffer(filename).toString('binary'));
res.setHeader('Content-type', mimetype);
let filestream = fs.createReadStream(filePath);
filestream.pipe(res);

对比发现，写法1比写法2简单的多，但是目前对于Safari、IE支持是不好的，如果直接用写法2，Edge又会有问题，这时又要牵扯对于不同浏览器，文件名中英文一堆的逻辑判断处理，
所以最好的解决办法是根据请求头部，对应处理下。
对于浏览器判别可以用下面的类库

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
const parser = require('ua-parser-js');
let ua = parser(req.headers['user-agent']);
 if (['Edge', 'Chrome', 'Firefox'].indexOf(ua.browser.name) > -1) {
            res.download(filePath, filename, function (err) {
                    if (err) {
                        logger.error('有错误');
                        logger.error(err)
                    }
                    else {

                    }
                }
            );
        }
        else {
            let mimetype = mime.lookup(filePath);
            res.setHeader('Content-type', mimetype);
            if (ua.browser.name == 'IE') {
                res.setHeader('Content-Disposition', 'attachment; filename=' + encodeURIComponent(filename));
            } /*else if (ua.browser.name == 'Firefox') {
             res.setHeader('Content-Disposition', 'attachment; filename*="utf8\'\'' + encodeURIComponent(filename) + '"');
             } */ else {
                /* safari等其他非主流浏览器只能自求多福了 */
                res.setHeader('Content-Disposition', 'attachment; filename=' + new Buffer(filename).toString('binary'));
            }
            let filestream = fs.createReadStream(filePath);
            filestream.pipe(res);
        }

浏览器支持

上述代码经过测试，支持以下浏览器

  • IE
  • Chrome
  • Firefox
  • Edge
  • 360(极速、兼容)
  • QQ(极速、兼容)