JavaScript不同场景下的文件下载方案详解

 更新时间:2023年12月27日 09:10:12   作者:云小遥  
这篇文章主要为大家详细介绍了JavaScript中不同场景下的三种常见文件下载方案,文中的示例代码讲解详细,有需要的小伙伴可以参考一下

文件下载实践方案汇总

前端开发中 常用 到的下载方式:

  • a标签下载(链接下载)
  • fetch / axios / XMLHttpRequest 异步请求资源下载
  • blob 下载
  • FileSaver 第三方库下载

除了以上几种通用性方案,在JQuery时期还会经常使用到 form 表单提交等方式,但是随着Vue、React的兴起,一般在进行选型时便很少使用form表单提交的形式了。

方案1:a标签下载

简单下载方式,通过a标签的href属性加载下载url,适合普通场景下的简单下载。

适合场景

  • get 请求
  • 返回为文件流 / 返回URL

不适合场景

  • 下载需要计算、权限验证、携带Cookie
  • 需要动态生成文件内容,即需要Post传参
  • 需要处理跨域问题
  • 需要处理大文件下载(10M以上)
  • 需要断点续传或文件下载进度监控等

应用示例

  <a 
     href="https://images.unsplash.com/photo-1682687982468-4584ff11f88a?ixlib=rb-4.0.3&q=85&fm=jpg&crop=entropy&cs=srgb&dl=neom-xDQKvPjxtxo-unsplash.jpg" 
     download="demo">下载图片</a>
function downLoadFile(res){
    const ele = document.createElement('a');
          ele.setAttribute('href',res.url); //设置下载文件的url地址
          ele.setAttribute('download' , 'download');//用于设置下载文件的文件名
          ele.click();
  
    link.addEventListener('click', (event) => {
      event.preventDefault();
      const downloadTimer = setTimeout(() => {
        alert('下载超时,请重试!');
      }, 5000); 

      const errorListener = () => {
        clearTimeout(downloadTimer);
        alert('下载失败!');
        link.removeEventListener('error', errorListener);
      };

      link.addEventListener('error', errorListener);
  });
}

window.onload = function(){
    $.ajax({
        url:"api/file/download",
        type:"get",
        dataType:'JSON'
    }).then(function(res){
        if(res.bizNO > 0 ){
            downLoadFile(res);
        }else{
            alert(res.bizMsg);
        }
   }).always(function(){
        alert("连接异常");
    })
}

扩展说明

关于优先级

Causes the browser to treat the linked URL as a download. Can be used with or without a filename value:

Without a value, the browser will suggest a filename/extension, generated from various sources:

The [Content-Disposition](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) HTTP header → 上面的demo示例中,即使设置了dowmload属性,由于响应头中包含 Content-Disposition:attachment;filename="neom-xDQKvPjxtxo-unsplash.jpg",所以下载图片名称以响应头为准

filename: defining a value suggests it as the filename. / and \ characters are converted to underscores (_). Filesystems may forbid other characters in filenames, so browsers will adjust the suggested name if necessary.

关于响应头Content-Disposition

Content-Disposition 是一个 HTTP 响应头,它指定了如何显示响应的内容,特别是对于以附件形式下载的文件。这个头部可以包含一个内联展示(inline)的选项,也可以包含一个附件(attachment)的选项,以及可选的文件名参数。

主要作用如下:

1.内联展示(inline)

  • 如果Content-Disposition头部的值设置为inline,浏览器通常会尝试在浏览器窗口内显示内容,例如在浏览器中直接打开 PDF 文件或图像。
  • 这对于一些直接浏览的文件类型是合适的。

2.附件下载(attachment)

  • 如果Content-Disposition头部的值设置为attachment,浏览器通常会提示用户下载文件,而不是直接在浏览器中显示。
  • 这对于需要用户保存到本地的文件,如文档、图像、音频和视频等,是常见的设置。

3.指定文件名

通过filename参数,可以指定下载文件的文件名。这对于确保用户下载的文件有一个明确的名称非常有用,而不是使用服务器上的默认文件名。

例如,Content-Disposition: attachment; filename="example.txt"

方案2: Blob 下载

基础概念

什么是blob

blob是File类的超类,表示 二进制大对象,是JS对不可修改二进制数据的封装类型

blob相关知识点

developer.mozilla.org/zh-CN/docs/Web/API/Blob

适合场景

  • 接口返回的格式为文件流格式
  • 下载需要计算、权限验证、携带Cookie
  • 需要动态生成文件内容,即需要Post传参

代码实现

function fileDownLoad(data){
    // 1. 创建点击下载的元素   
    var linkElement = document.createElement('a');
  
    // 2. 判断浏览器是否支持blob对象
    try{
        //该实例化的方式第一个参数必须是数组的格式
        var blob = new Blob([data],{
          type: "application/pdf"
        });
    }catch(e){
        //旧版本浏览器下的blob创建对象
        window.BlobBuilder = window.BlobBuilder ||
                             window.WebKitBlobBuilder ||
                             window.MozBlobBuilder ||
                             window.MSBlobBuilder;
        if(e.name == 'TypeError' && window.BlobBuilder){
            var blobbuilder = new BlobBuilder();
            BlobBuilder.append(data);
            var blob = blobbuilder.getBlob("application/pdf");
        }else{
            alert("浏览器版本较低,暂不支持该文件类型下载");
        }
    }
  
    // 提取blob文件中的url信息,使二进制文件在不读取到js中时直接下载
    let url = window.URL.createObjectURL(blob);
    linkElement.setAttribute('href',url);
    linkElement.setAttribute('downLoad','download');
    linkElement.click();
    
    // 释放URL内存
    window.URL.revokeObjectURL(url);
}

document.querySelector('#fileInput').addEventListener('change', (event)=>{
  fileDownLoad(event.target.files[0])
})

下载接口需要携带Cookie信息

function downloadFileWithToken(url, token) {
    let xhr = new XMLHttpRequest();
    xhr.open('GET', url, true);
    xhr.setRequestHeader("Authorization", token);
    xhr.responseType = 'blob';
    xhr.onload = function (e) {
        if (this.status === 200) {
            let blob = this.response;
            let fileName = '下载的文件名称';
            // 针对IE浏览器          
            if (window.navigator.msSaveBlob) {
                try {
                    window.navigator.msSaveBlob(blob, fileName);
                } catch (e) {
                    console.log(e);
                }
            } else {
                // 通用浏览器   
                const url = window.URL.createObjectURL(blob);
                a.href = url;
                a.download = fileName;
                document.body.appendChild(a);
                a.click();
                document.body.removeChild(a);
                window.URL.revokeObjectURL(url);
            }
        } else {
            alert('下载文件失败');
        }
    }
    xhr.send();
}

方案3:FileSaver实现

基础介绍

基础使用

import FileSaver from 'file-saver'

let blob = new Blob(["Hello, FileSaver! Blob 下载"], {type: "text/plain;charset=utf-8"});
window.saveAs(blob, "hello FileSaver.txt");
import FileSaver from 'file-saver'

let blob = new Blob(["Hello, FileSaver! URL 下载"], {type: "text/plain;charset=utf-8"});
const url = window.URL.createObjectURL(blob)
window.saveAs(url, "hello FileSaver.txt");

原理介绍

以上就是JavaScript不同场景下的文件下载方案详解的详细内容,更多关于JavaScript文件下载的资料请关注脚本之家其它相关文章!

相关文章

  • 简单实现Bootstrap标签页

    简单实现Bootstrap标签页

    这篇文章主要教大家简单实现Bootstrap标签页,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-12-12
  • js调用浏览器打印模块实现点击按钮触发自定义函数

    js调用浏览器打印模块实现点击按钮触发自定义函数

    把浏览器打印的功能保留并赋予到自己添加的按钮当中,可以在点击按钮的同时触发自定义的函数
    2014-03-03
  • js实现一键复制功能

    js实现一键复制功能

    本文主要介绍了js实现一键复制功能的方法,具有很好的参考价值。下面跟着小编一起来看下吧
    2017-03-03
  • JavaScript中DOM和BOM的区别与用处详解

    JavaScript中DOM和BOM的区别与用处详解

    这篇文章主要介绍了JavaScript中DOM和BOM的区别与用处,DOM和BOM是前端开发中常用的两个概念,它们分别表示不同的对象模型,用于操作浏览器的不同部分,了解它们的区别和用处,有助于在前端开发中灵活使用 JavaScript 操作页面和浏览器,需要的朋友可以参考下
    2024-09-09
  • 详解 微信小程序开发框架(MINA)

    详解 微信小程序开发框架(MINA)

    小程序使用的是MINA框架,目的是通过简单、高效的方式让开发者可以在微信中开发具有原生App体验的服务。 这篇文章主要介绍了微信小程序开发框架(MINA),需要的朋友可以参考下
    2019-05-05
  • JavaScript实现获取最近7天的日期的方法详解

    JavaScript实现获取最近7天的日期的方法详解

    这篇文章主要想和大家分享一些JavaScript开发中会用到的小技巧,本文主要介绍了js获取最近7天的日期,判断当前日期时间大于指定日期时间等内容,需要的可以参考一下
    2023-04-04
  • extjs中form与grid交互数据(record)的方法

    extjs中form与grid交互数据(record)的方法

    这篇文章介绍了extjs中form与grid交互数据(record)的方法,有需要的朋友可以参考一下
    2013-08-08
  • 用JS实现贪吃蛇游戏

    用JS实现贪吃蛇游戏

    这篇文章主要为大家详细介绍了用JS实现贪吃蛇游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-07-07
  • bootstrap监听滚动实现头部跟随滚动

    bootstrap监听滚动实现头部跟随滚动

    这篇文章主要为大家详细介绍了bootstrap监听滚动实现头部跟随滚动,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • !DOCTYPE声明对JavaScript的影响分析

    !DOCTYPE声明对JavaScript的影响分析

    DOCTYPE是document type(文档类型)的简写,在web设计中用来说明你用的XHTML或者HTML是什么版本。
    2010-04-04

最新评论