javascript 实现原生下载的各种情况

还记得第一次做文档下载的时候，基于windows.open('download_url')的方式下载。在某天某月某日，有领导突然review我的代码，此种方式遭到吐槽，尴尬不已。才痛下决心决定梳理一下前台的下载功能

windows.open缺点 1.用户交互不友好 2.对于图片类型的文件，会直接打开浏览器，而不是下载等等，自己领悟

下方的方式很多，请根据实际业务需求动态选择

1：一般通过a标签的方式下载，利用H5的Download属性

代码示例如下：

场景：适用于现代浏览器，url是下载地址，而不是文件流，常用于GET请求

function downLoad(downUrl, fileName) {
  let a = document.createElement("a");// 创建a标签
  if ('download' in a) {
    a.download = fileName;// 设置下载文件的文件名
  }
  (document.body || document.documentElement).appendChild(a);
  a.href = downUrl;// downUrl为后台返回的下载地址
  a.target = '_parent';
  a.click();// 设置点击事件
  a.remove(); // 移除a标签
}

downLoad(URL, 'test.xlxs') //URL下载地址

如果后台给的是文件流，则利于Blob对象包装一下文件流，常用于POST请求

代码示例如下：

function downLoad(content, fileName) {
  let a = document.createElement("a"),// 创建a标签
      blob = new Blob([content]);  //用Blob对象包装一下文件流

  if ('download' in a) {
    a.download = fileName;// 设置下载文件的文件名
  }
  (document.body || document.documentElement).appendChild(a);
  a.href = window.URL.createObjectUrl(blob);;// content为后台返回的文件流
  a.click();// 设置点击事件
  a.remove(); // 移除a标签
}
downLoad('我是文件流我是文件流', 'test.txt')

如果是POST请求，可以借助axios实现，配合FileReader对象。

axios.post(downloadUrl, this.searchParams, {
  responseType: 'blob'
}).then(res => {
  const blob = res.data
  const reader = new FileReader()
  reader.readAsDataURL(blob)
  reader.onload = (e) => {
    const a = document.createElement('a')
    a.download = `表格名称.xlsx`
    a.href = e.target.result
    document.body.appendChild(a)
    a.click()
    document.body.removeChild(a)
  }
}).catch(err => {
  console.log(err.message)
})

2：借助Base64实现文件的下载

对于非文本文件，也是可以借助JS下载的，比如下载图片，前端直接可以转化为base64然后下载

直接上实例代码吧，应该都看得懂，我就不多说了，

代码来自张鑫旭的关于下载的博文，可以直接查看

function download (domImg, filename) {
  // 创建隐藏的可下载链接
  let eleLink = document.createElement('a');
  eleLink.download = filename;
  eleLink.style.display = 'none';
  // 图片转base64地址
  let canvas = document.createElement('canvas');
  let context = canvas.getContext('2d');
  let width = domImg.naturalWidth;
  let height = domImg.naturalHeight;
  context.drawImage(domImg, 0, 0);
  // 如果是PNG图片，则canvas.toDataURL('image/png')
  eleLink.href = canvas.toDataURL('image/jpeg');
  // 触发点击
  document.body.appendChild(eleLink);
  eleLink.click();
  // 然后移除
  document.body.removeChild(eleLink);
};

 3：通过formData标签的方式下载，这是平安易建产品所使用的下载方式，兼容低版本浏览器

直接上代码，因为涉及到加签验签和平安的实际业务，所以看不懂就不用看了，直接上代码，用于自己以后参考

function downfile(file) {
  if (file == undefined || file == null) {
    return;
  }
  const nonce = Math.floor(Math.random() * (Math.floor(100) - Math.ceil(1))) + Math.ceil(1);
  const timestamp = parseInt(Date.now() / 1000);
  const searchParams = {
    storageKey: file.storageKey, // 文件系统文件key
    tokenType: 2, // 申请token的类型，1：上传，2：下载，5：预览
    nonce,
    timestamp,
    alg: 'MD5',
  };
  axios({ url: '/docs/api/file/token/applyToken', method: 'get', params: searchParams })
    .then(res => {
      if (!res.status === 200 || !res.data) {
        return;
      } if (!res.data.success) {
        const msg = res.data.msg && res.data.msg.length > 0 ? res.data.msg : '下载失败！';
        message.error(msg);

      } else {
        res = res.data || {};
        let content = {};
        if (res.data.contentList && res.data.contentList.length > 0) {
          content = res.data.contentList[0];
        }
        return {
          nodeUrl: content.nodeUrl,
          token: content.token
        }
      }
    }).then(({ nodeUrl, token }) => {
      const url = `${nodeUrl}/node/download/view/${file.storageKey}`; // 文件下载路径
      const form = document.createElement('form');
      form.setAttribute("method", "get");
      form.setAttribute("name", "theForm");
      form.setAttribute("target", "_self");
      form.setAttribute('style', 'display:none');
      form.setAttribute("action", url);
      document.body.appendChild(form);

      const newinput_fileToken = document.createElement('input');
      newinput_fileToken.setAttribute('type', 'hidden');
      newinput_fileToken.setAttribute('name', 'fileToken');
      newinput_fileToken.setAttribute('value', token)

      const newinput_fileName = document.createElement('input');
      newinput_fileName.setAttribute('type', 'hidden');
      newinput_fileName.setAttribute('name', 'fileName');
      newinput_fileName.setAttribute('value', file.name)

      form.appendChild(newinput_fileToken);
      form.appendChild(newinput_fileName);

      form.submit();
      document.theForm.parentNode.removeChild(form);
    });
}

另附折叠版的批量下载，实际上差不多一样，如果以后实际项目中遇到，可以综合在一起

function batchDownfile(files, useType) {
  if(files == undefined || files == null || files.length == 0){
    return;
  }
  let applyTokenForms = [];
  const hasDoc = files.some(file => file.type == 1)
  if(hasDoc){
    applyTokenForms = files.map(it => ({
      fileId: it.id
    }))
  } else {
    applyTokenForms = files.map(it => ({
      storageKey: it.storageKey,
      fileName: it.name
    }))
  }
  const param = hasDoc ? {
    useType: 11
  } : {}
  if(useType){
    param.useType = useType
  }
  const nonce = Math.floor(Math.random()*(Math.floor(100)-Math.ceil(1)))+Math.ceil(1);
  const timestamp = parseInt(Date.now()/1000);
  const searchParams = {
    ...param,
    applyTokenForms,
    tokenType: 4, // 申请token的类型，1：上传，2：下载，4, 批量下载, 5：预览
    nonce,
    timestamp,
    alg:'MD5',
  }; 
  const newParam =  setParamSign(JSON.parse(JSON.stringify(searchParams)));
  axios.post(`/docs/api/file/token/applyTokens`,parse(newParam))
    .then(res => {
      if (!res.status === 200 || !res.data){ 
        return; 
      }if(!res.data.success){
        const msg = res.data.msg && res.data.msg.length > 0 ? res.data.msg : '下载失败！';
        message.error(msg);  
              
      }else{
        res = res.data || {};
        let fileList = [];
        let nodeUrl = '';
        let zipName = '';
        if(res.data && res.data.length > 0){
          fileList = res.data.map(it => {
            let file = {};
            if(it.contentList && it.contentList.length > 0){
              if(zipName == ''){
                zipName = `${files.length > 1 ? `${files[0].name  }等` : (files.length == 1 ? files[0].name : '未知')  }.zip`
              }
              const firstContent = it.contentList[0];
              file = {
                fileId: firstContent.fileId,
                fileName: firstContent.filePath,
                token: firstContent.token
              }
              if(nodeUrl == ''){
                nodeUrl = firstContent.nodeUrl
              }
            }
            return file;
          })
        }
        return {
          fileList,
          nodeUrl,
          zipName
        }
      }
    }).then(({fileList, nodeUrl, zipName}) => {
      const url = `${nodeUrl  }/node/zip/json`; // 文件下载路径
      const form = document.createElement('form');
      form.setAttribute("method", "post"); 
      form.setAttribute("name", "theForm");
      form.setAttribute("target", "_self");
      form.setAttribute('style', 'display:none');
      form.setAttribute("action", url); 
      document.body.appendChild(form);

      const newinput = document.createElement('input');
      newinput.setAttribute('type','hidden');
      newinput.setAttribute('name','strFileList');
      newinput.setAttribute('value',JSON.stringify(fileList))

      const newinput2 = document.createElement('input');
      newinput2.setAttribute('type','hidden');
      newinput2.setAttribute('name','zipName');
      newinput2.setAttribute('value', zipName)

      form.appendChild(newinput);
      form.appendChild(newinput2);
      form.submit();
      document.theForm.parentNode.removeChild(form);
    });
}

暂时结束，以后补充，还可以采用FormData对象实现下载，和$('Form')差不多，这里就不一一列举了