通過JavaScript下載文件到本地的方法（單文件）

更新時間：2019年03月17日 14:44:11 作者：小閑

這篇文章主要介紹了通過JavaScript下載文件到本地的方法（單文件），文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

最近在做一個文件下載的功能，這里把做的過程中用的技術(shù)和坑簡要總結(jié)下。

1. 單文件下載(a標簽)

同源單文件

針對單文件的情況下，同源的文件，可以通過 < a> 標簽的 download 屬性下載文件

 const elt = document.createElement('a');
 elt.setAttribute('href', url);
 elt.setAttribute('download', 'file.png');
 elt.style.display = 'none';
 document.body.appendChild(elt);
 elt.click();
 document.body.removeChild(elt);

但是這個方案并不適用于非同源的資源，此時它相當于普通的超鏈接，點擊會跳轉(zhuǎn)到資源頁面，而不是下載。

非同源圖片

如果不存在CORS問題, 可以借助Blob實現(xiàn)下載(構(gòu)造xhr請求文件地址, 以Blob的形式接收Response)：

function downloadWithBlob(url) {
 fetch(url).then(res => res.blob().then(blob => {
  var a = document.createElement('a');
  var url = window.URL.createObjectURL(blob);
  var filename = 'file.png';
  a.href = url;
  a.download = filename;
  a.click();
  window.URL.revokeObjectURL(url);
 }));
}

如果存在CORS問題，可以考慮使用 canvas 將圖片轉(zhuǎn)換成 base64 編碼之后再通過標簽的 download 屬性下載

function downloadPic(url) {
 const img = new Image;
 const canvas = document.createElement('canvas');
 const ctx = canvas.getContext('2d');
 img.onload = function() {
  canvas.width = this.width;
  canvas.height = this.height;
  ctx.drawImage(this, 0, 0);

  const elt = document.createElement('a');
  elt.setAttribute('href', canvas.toDataURL('image/png'));
  elt.setAttribute('download', 'file.png');
  elt.style.display = 'none';
  document.body.appendChild(elt);
  elt.click();
  document.body.removeChild(elt);
 };
 img.crossOrigin = 'anonymous';
 img.src = url;
}

2. 單文件下載(iframe)

iframe方式是在頁面內(nèi)隱藏iframe, 然后將下載地址加載到iframe中, 從而觸發(fā)瀏覽器的下載行為

 const iframe = document.createElement('iframe');
 iframe.src = url;
 iframe.style.display = 'none';
 document.body.appendChild(iframe);

但是這里發(fā)現(xiàn)，即使是同域的圖片，也無法完成下載，這是為啥呢？

這里就有個上面的a鏈接下載沒有提到的問題：什么樣的鏈接才能觸發(fā)瀏覽器的下載:

url如何觸發(fā)瀏覽器自動下載

一個url能否觸發(fā)瀏覽器自動下載，主要看該請求響應(yīng)頭response header是否滿足，一般是看Content-Disposition和Content-Type這兩個消息頭：

response header中指定了Content-Disposition為attachment，它表示讓瀏覽器把消息體以附件的形式下載并保存到本地 (一般還會指定filename, 下載的文件名默認就是filename)
response header中指定了Content-Type 為 application/octet-stream(無類型) 或 application/zip(zip包時)等等。(其中 application/octet-stream表示http response為二進制流(沒指定明確的type), 用在未知的應(yīng)用程序文件，瀏覽器一般不會自動執(zhí)行或詢問執(zhí)行。瀏覽器會像對待設(shè)置了HTTP頭Content-Disposition 值為 attachment 的文件一樣來對待這類文件)

只要url滿足上述觸發(fā)的要求，那么都可以通過iframe的形式來下載

3. 代理服務(wù)處理下載

如果后端自己也能控制的話，或者后端能配合的話，可以寫一個代理服務(wù)，在后端去請求文件數(shù)據(jù)，然后設(shè)置好相應(yīng)的response header，然后前端請求代理服務(wù)來做下載。

前端(假設(shè)代理服務(wù)接口是http://exampale.com/download)：

 const downloadUrl = 'http://exampale.com/download?url=' + encodeURIComponent(url) + '&name=xxx';
 const elt = document.createElement('a');
 elt.setAttribute('href', downloadUrl);
 elt.setAttribute('download', 'file.png');
 ...

后端

const url = decodeURIComponent(req.query.url);
http.get(url, (response) => {
 res.setHeader('Content-disposition', 'attachment;filename=' + req.query.name);
 res.setHeader('Content-type', 'application/octet-stream');
 response.pipe(res);
});

單文件的處理先寫到這里，多文件的下載下篇在寫。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: