使用js直接下载pdf文件而不用在新的浏览器窗口打开

最近接了一个需求,要求用户点击下载按钮后直接下载pdf文件,而不是打开一个新窗口,让用户再去手动保存。

接到需求后我立刻着手在网上查找文档,发现很多声称可以实现直接下载的方法都不行,只有下面这个方法成功实现了我的需求,现在翻译过来,供更多的人使用。

原文:How to trigger the direct download of a PDF with JavaScript

现在的web应用基本都运行在现代浏览器上,科技的进步使得我们有很多新的API接口可以调用,其中一个优势是我们可以直接使用blob和FileReader下载文件,而不用重定向到一个新的标签页。

在这篇文章中,我将将演示在一个web页面中,直接通过url下载一个pdf文件。

注意

在案例中我们将下载use a PDF hosted in the Mozilla Github IO website,因为它是免费的而且设置好了CORS 头,我们可以在任何地方使用而不用担心跨域问题。

依赖

需要使用FileSaver库来实现下载的目标。这个库支持UMD,所以你可以直接在script标签中引入,也可以引入模块中使用。

如果你使用npm,你可以这样安装它:

npm install file-saver --save

然后你就可以像下面这样使用它了:

1
2
3
var FileSave = require('file-save');
var blob = new Blob(["hello world!"], {type: "text/plain;charset=utf-8"});
FileSaver.saveAs(blob, "hello World.txt");

或者

1
2
3
import FileSave from 'file-save';
var blob = new Blob(["hello world!"], {type: "text/plain;charset=utf-8"});
FileSaver.saveAs(blob, "hello World.txt");

另外,你还可以直接下载FileSaver然后在标签中使用它。

如下首先引入js文件

1
<script src="FileSaver.min.js"></script>

然后使用

1
2
3
var blob = new Blob(["Hello, world!"], {type: "text/plain;charset=utf-8"});

saveAs(blob, "hello world.txt");

点此点此查看官方文档

使用url直接下载pdf

多亏了FileSaver.js,你可以很容的用JavaScript在浏览器中保存文件数据。FileSaver.js实现了浏览器不支持直接下载的功能,它是在客户端下载文件,保存web应用数据,或者发送到服务器比较敏感的数据。

在这样的场景下,你想下载服务器上的pdf文件,但由于某些原因不想让用户产生点击等行为,你可以使用FileSaver.js轻松实现。在下面的例子中,我们通过一个简单的url下载pdf,根据你的web应用的使用场景,pdf文件仅仅在服务器满足某些条件的时候才可以下载,最后通过JavaScript下载和处理。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
var oReq = new XMLHttpRequest();
// The Endpoint of your server
var URLToPDF = "https://mozilla.github.io/pdf.js/web/compressed.tracemonkey-pldi-09.pdf";

// Configure XMLHttpRequest
oReq.open("GET", URLToPDF, true);

// Important to use the blob response type
oReq.responseType = "blob";

// When the file request finishes
// Is up to you, the configuration for error events etc.
oReq.onload = function() {
// Once the file is downloaded, open a new window with the PDF
// Remember to allow the POP-UPS in your browser
var file = new Blob([oReq.response], {
type: 'application/pdf'
});

// Generate file download directly in the browser !
saveAs(file, "mypdffilename.pdf");
};

oReq.send();

当文件下载结束的时候,保存程序会自动开始保存。

提醒一下哦,如果浏览器不支持Blob,可以使用这个补丁哦.