最近接了一个需求,要求用户点击下载按钮后直接下载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 | var FileSave = require('file-save'); |
或者
1 | import FileSave from 'file-save'; |
另外,你还可以直接下载FileSaver然后在标签中使用它。
如下首先引入js文件
1 | <script src="FileSaver.min.js"></script> |
然后使用
1 | var blob = new Blob(["Hello, world!"], {type: "text/plain;charset=utf-8"}); |
点此点此查看官方文档
使用url直接下载pdf
多亏了FileSaver.js,你可以很容的用JavaScript在浏览器中保存文件数据。FileSaver.js实现了浏览器不支持直接下载的功能,它是在客户端下载文件,保存web应用数据,或者发送到服务器比较敏感的数据。
在这样的场景下,你想下载服务器上的pdf文件,但由于某些原因不想让用户产生点击等行为,你可以使用FileSaver.js轻松实现。在下面的例子中,我们通过一个简单的url下载pdf,根据你的web应用的使用场景,pdf文件仅仅在服务器满足某些条件的时候才可以下载,最后通过JavaScript下载和处理。
1 | var oReq = new XMLHttpRequest(); |
当文件下载结束的时候,保存程序会自动开始保存。
提醒一下哦,如果浏览器不支持Blob,可以使用这个补丁哦.