【Web技術】1787- 前端文件下載的正確打開方式
作者： 田八
https://juejin.cn/post/7156427561302982670
前端涉及到的文件下載還是很多應用場景的，那么前端文件下載有多少種方式呢？每種方式有什么優(yōu)缺點呢？下面就來一一介紹。
1. a 標簽
通過a標簽的download屬性來實現(xiàn)文件下載，這種方式是最簡單的，也是我們比較常用的方式，先來看示例代碼：
<a href="http://www.baidu.com" download="baidu.html">下載</a>
就上面的這個示例，我們點擊下載，發(fā)現(xiàn)是跳轉到了百度的首頁，并沒有真的下載文件。
因為a標簽下載只能下載同源的文件，如果是跨域的文件，這里包括圖片、音視頻等媒體文件，都是預覽，也無法下載。
上面的代碼是直接通過書寫a標簽來實現(xiàn)文件下載，我們也可以通過js來實現(xiàn)，代碼如下：
const a = document.createElement('a')
a.href = 'http://www.baidu.com'
a.download = 'baidu.html'
a.click()
效果和上面的一樣，都是跳轉到百度的首頁，沒有下載文件。
這里的重點是a標簽的download屬性，這個屬性是HTML5新增的。
它的作用是指定下載的文件名，如果不指定，那么下載的文件名就會根據(jù)請求內容的Content-Disposition來確定，如果沒有Content-Disposition，那么就會使用請求的URL的最后一部分作為文件名。
2. window.open
上面使用a標簽的案例也可以通過window.open來實現(xiàn)，效果是一樣的，代碼如下：
window.open('http://www.baidu.com', '_blank')
這里的_blank是指定打開的方式，如果不指定，那么就會在當前頁面打開，這里指定_blank，就是在新的頁面打開。
同樣a標簽的download屬性也是可以使用的，代碼如下：
window.open('http://www.baidu.com', '_blank', 'download=baidu.html')
當然這種方式也是有缺陷的，對比于a標簽，這種方式不能下載.html、.htm、.xml、.xhtml等文件，因為這些文件會被當成html文件來處理，所以會直接在當前頁面打開。
同樣也不能下載跨域的文件，畢竟是window.open，不是window.download（window.download是假想）。
3. location.href
這種方式和window.open(url)是一樣的，代碼如下：
location.href = 'http://www.baidu.com'
這種方式擁有window.open的所有缺陷，所以不推薦使用，這里只當作了解，所以不做過多的講解。
4. location.?其他屬性
這里的其他指代的都是能跳轉頁面的屬性，比如location.assign、location.replace、location.reload等，這些屬性都是可以實現(xiàn)文件下載的，代碼如下：
location.assign('http://www.baidu.com')
location.replace('http://www.baidu.com')
location.reload('http://www.baidu.com')
這里的location.reload是有點特殊的，它的作用是重新加載當前頁面，但是它也可以接受一個參數(shù)，這個參數(shù)就是要跳轉的頁面，所以也可以實現(xiàn)文件下載。
當然同location.href一樣，這些方式的缺點都一樣，同時還有屬于每個屬性自身的特性，這里只當拓展知識，不做過多的講解。
5. XMLHttpRequest
這種方式就是我們常說的ajax下載，包括axios、fetch等都是相同的，代碼如下：
const xhr = new XMLHttpRequest()
xhr.open('GET', 'http://www.baidu.com')
xhr.send()
xhr.onload = function () {
const blob = new Blob([xhr.response], { type: 'text/html' })
const a = document.createElement('a')
a.href = URL.createObjectURL(blob)
a.download = 'baidu.html'
a.click()
}
這里就不講和XMLHttpRequest相關的知識了，只講和文件下載相關的部分。
這里主要的邏輯是當我們的請求成功后，我們會拿到響應體的response，這個response就是我們要下載的內容，然后我們把它轉換成blob對象，然后通過URL.createObjectURL來創(chuàng)建一個url，然后通過a標簽的download屬性來實現(xiàn)文件下載。
這里的知識點就有兩個，一個是blob對象，一個是URL.createObjectURL。
5.1 blob
下面是blob對象的定義，來自MDN[1]：
Blob對象表示一個不可變、原始數(shù)據(jù)的類文件對象。它的數(shù)據(jù)可以按文本或二進制的格式進行讀取，也可以轉換成ReadableStream來用于數(shù)據(jù)操作。
Blob表示的不一定是JavaScript原生格式的數(shù)據(jù)。File接口基于Blob，繼承了blob的功能并將其擴展以支持用戶系統(tǒng)上的文件。
blob對象是html5新增的對象，它的作用是用來存儲二進制數(shù)據(jù)的，比如圖片、視頻、音頻等，它的使用方法如下：
/**
* @param {Array} array 二進制數(shù)據(jù)
* @param {Object} options 配置項
* @param {String} options.type 文件類型，它代表了將會被放入到 blob 中的數(shù)組內容的 MIME 類型。
* @param {String} options.endings 用于指定包含行結束符\n的字符串如何被寫入。默認為transparent，表示不會修改行結束符。還可以指定為native，表示會將\n轉換為\r\n。
*/
const blob = new Blob([], { type: '' })
這里主要關注的是type屬性，默認情況下，blob對象是沒有type屬性的，那么這個Blob就是一個無類型的Blob，文件不會損毀，但是無法被正常識別。
5.2 URL.createObjectURL
下面來自MDN[2]：
URL.createObjectURL() 靜態(tài)方法會創(chuàng)建一個 DOMString，其中包含一個表示參數(shù)中給出的對象的 URL。這個 URL 的生命周期和創(chuàng)建它的窗口中的 document 綁定。這個新的 URL 對象表示指定的 File 對象或 Blob 對象。
這個方法是用來創(chuàng)建一個url的，它的作用是把一個blob對象轉換成一個url，這個url可以用來下載文件，也可以用來預覽文件，代碼如下：
const url = URL.createObjectURL(blob)
這里需要注意的是，這個url的生命周期和創(chuàng)建它的窗口中的document綁定，也就是說，當我們的document被銷毀后，這個url就會失效，所以我們需要在合適的時機銷毀它，代碼如下：
URL.revokeObjectURL(url)
回到我們剛才下載的問題，我們是通過blob對象來解決，但是我們的type屬性是寫死的，如果在文件類型是確定的情況下是沒問題的，但是如果這個接口就是下載文件的接口，文件可能是各種類型的，我們應該怎么處理？
這里的沒有正確答案，第一個可以和接口提供者進行協(xié)商，協(xié)商方案是不確定的，第二就是通過response的header來獲取文件的type，也是我們要講的：
const type = response.headers['content-type']
const blob = new Blob([response.data], { type })
這里我們通過response的header來獲取type，然后再創(chuàng)建blob對象，這樣就可以正確的下載文件了。
其實content-type也可能是application/octet-stream，這個時候我們就需要通過file-type來獲取文件的type了。
下面的代碼是通過file-type來獲取文件的type：
import {fileTypeFromStream} from 'file-type';
const type = await fileTypeFromStream(response.body);
const blob = new Blob([response.data], { type })
file-type的使用可以參考這里[3]。
6. 總結
上面的方案這么多，其實最終還是落到a標簽上，所以不管是通過瀏覽器的內置行為進行下載，還是通過ajax進行下載，文件下載的最終還是瀏覽器的行為。
參考資料
[1]MDN: https://developer.mozilla.org/zh-CN/docs/Web/API/Blob
[2]MDN: https://developer.mozilla.org/zh-CN/docs/Web/API/URL/createObjectURL
[3]這里: https://github.com/sindresorhus/file-type
往期回顧
#
如何使用 TypeScript 開發(fā) React 函數(shù)式組件？
# # # #6 個你必須明白 Vue3 的 ref 和 reactive 問題
# #
回復“加群”，一起學習進步