前端實現文件下載並重命名(兼容IE)

引出

🎨當我們在前端進行遠程文件下載時，如果默認的文件名不是我們需要的，我們希望能夠對下載的文件進行重新命名，今天介紹三種常用方法。

一、HTML download 屬性

<a href="/images/myw3schoolimage.jpg" download="w3logo">

filename 規定作為文件名來使用的文本
注意：

1. 在 HTML5 中，download 屬性是 標簽的新屬性
2. download僅支持同源策略，如果非同源的話，需要跨域處理
3. 瀏覽器支持十分不友好
   

二、文件流下載，兼容IE

/**
 * 獲取 blob
 * @param  {String} url 目標文件地址
 * @return {Promise} 
 */
function getBlob(url) {
    return new Promise(resolve => {
        const xhr = new XMLHttpRequest();

        xhr.open('GET', url, true);
        xhr.responseType = 'blob';
        xhr.onload = () => {
            if (xhr.status === 200) {
                resolve(xhr.response);
            }
        };

        xhr.send();
    });
}

/**
 * 保存
 * @param  {Blob} blob     
 * @param  {String} filename 想要保存的文件名稱
 */
function saveAs(blob, filename) {
    if (window.navigator.msSaveOrOpenBlob) {
        navigator.msSaveBlob(blob, filename);
    } else {
        const link = document.createElement('a');
        const body = document.querySelector('body');

        link.href = window.URL.createObjectURL(blob);
        link.download = filename;

        // fix Firefox
        link.style.display = 'none';
        body.appendChild(link);
        
        link.click();
        body.removeChild(link);

        window.URL.revokeObjectURL(link.href);
    }
}

/**
 * 下載
 * @param  {String} url 目標文件地址
 * @param  {String} filename 想要保存的文件名稱
 */
function download(url, filename) {
    getBlob(url).then(blob => {
        saveAs(blob, filename);
    });
}

因為IE的msSaveBlob只接收blob，所以這里先獲取文件的blob，然后針對IE和非IE瀏覽器做單獨處理。

使用

<a onClick={() => download(url, fileName)}>下載</a> //ES6寫法

注意：IE要10+以上

三、FileSaver.js插件

1. 安裝

npm install file-saver --save

或者(需下載FileSaver.js文件：

<script src="path/FileSaver.js"/>

2. 引用

import FileSaver from 'file-saver';

3. 使用

FileSaver.saveAs(Blob/File/Url, filename);

兼容性及更多用法，請查看https://github.com/eligrey/FileSaver.js