利用JS下载文件到本地

一、下载文件的基本方法

利用JavaScript下载文件的方法主要就是创建一个a标签并进行点击操作。具体步骤为:

function downloadFile(url) {
  var link = document.createElement("a");
  link.download = url.split("/").pop();
  link.href = url;
  document.body.appendChild(link);
  link.click();
  document.body.removeChild(link);
}

通过createElement方法创建一个a标签,然后将要下载文件url赋值给href属性,同时将下载的文件命名为url的最后一部分并赋值给download属性。最后将a标签加入到文档结构中并手动触发点击事件,就可以让浏览器开始下载文件。

二、利用XMLHttpRequest进行文件下载

另外一种文件下载的方法是利用XMLHttpRequest进行下载。具体步骤为:

function downloadFile(url) {
  var xhr = new XMLHttpRequest();
  xhr.open("GET", url);
  xhr.responseType = "blob";
  xhr.onload = function() {
    var a = document.createElement("a");
    a.href = window.URL.createObjectURL(xhr.response);
    a.download = url.split("/").pop();
    a.style.display = "none";
    document.body.appendChild(a);
    a.click();
    document.body.removeChild(a);
  };
  xhr.send();
}

创建一个XMLHttpRequest对象并使用open方法进行请求,需要注意设置responseType属性为blob,这表示响应数据为二进制文件对象。设置onload函数,获取到响应后创建一个a标签,将响应数据赋值给href属性,并设置下载文件的名称。将a标签隐藏起来并插入到文档结构中,手动触发点击事件完成文件下载操作。

三、处理下载错误

文件下载可能会因为多种原因失败,比如服务器异常、网络错误等。为了让用户体验更加友好,我们可以在文件下载发生异常时进行错误处理。具体处理方式如下:

function downloadFile(url) {
  var xhr = new XMLHttpRequest();
  xhr.open("GET", url);
  xhr.responseType = "blob";
  xhr.onerror = function() {
    console.error("文件下载失败");
  };
  xhr.onload = function() {
    if (xhr.status === 200) {
      var a = document.createElement("a");
      a.href = window.URL.createObjectURL(xhr.response);
      a.download = url.split("/").pop();
      a.style.display = "none";
      document.body.appendChild(a);
      a.click();
      document.body.removeChild(a);
    } else {
      console.error("文件下载失败");
    }
  };
  xhr.send();
}

在XMLHttpRequest对象上设置onerror回调函数,当下载发生错误时打印错误信息。在onload回调函数中增加一个判断语句,判断请求状态是否为200(即成功),如果成功则进行文件下载操作,否则也打印错误信息。这样可以让用户在文件下载发生异常时及时得到反馈。

四、文件下载进度条

为了提高用户使用体验,我们可以为文件下载添加一个进度条,让用户能够清楚地知道下载的进度。具体方法如下:

function downloadFile(url) {
  var xhr = new XMLHttpRequest();
  xhr.open("GET", url);
  xhr.responseType = "blob";
  var progressBar = document.createElement('div');
  progressBar.style = 'width: 0%; height: 4px; background-color: #4CAF50; position: fixed; top: 0; left: 0; z-index: 9999;';
  document.body.appendChild(progressBar);
  xhr.onprogress = function(e) {
    var percent = e.loaded / e.total * 100;
    progressBar.style.width = percent + '%';
  };
  xhr.onload = function() {
    if (xhr.status === 200) {
      var a = document.createElement("a");
      a.href = window.URL.createObjectURL(xhr.response);
      a.download = url.split("/").pop();
      a.style.display = "none";
      document.body.appendChild(a);
      a.click();
      document.body.removeChild(a);
    } else {
      console.error("文件下载失败");
    }
    document.body.removeChild(progressBar);
  };
  xhr.send();
}

利用XMLHttpRequest对象的onprogress回调函数可以监测到文件下载的进度。在该函数中计算出当前下载的进度并对进度条进行相应的设置。在onload回调函数中移除进度条,同时加入文件下载的处理逻辑。

五、跨域下载问题

由于浏览器的同源策略,如果下载文件的URL与当前页面的域名不一致,就会出现跨域下载问题。一般可以使用CORS(Cross-Origin Resource Sharing)来解决跨域下载问题。如果服务器端设置了CORS支持,JavaScript端下载文件时也需要设置相关的请求头,代码如下:

function downloadFile(url) {
  var xhr = new XMLHttpRequest();
  xhr.open("GET", url);
  xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
  xhr.setRequestHeader("Access-Control-Allow-Origin", "*");
  xhr.setRequestHeader("Access-Control-Allow-Methods", "GET");
  xhr.responseType = "blob";
  var progressBar = document.createElement('div');
  progressBar.style = 'width: 0%; height: 4px; background-color: #4CAF50; position: fixed; top: 0; left: 0; z-index: 9999;';
  document.body.appendChild(progressBar);
  xhr.onprogress = function(e) {
    var percent = e.loaded / e.total * 100;
    progressBar.style.width = percent + '%';
  };
  xhr.onload = function() {
    if (xhr.status === 200) {
      var a = document.createElement("a");
      a.href = window.URL.createObjectURL(xhr.response);
      a.download = url.split("/").pop();
      a.style.display = "none";
      document.body.appendChild(a);
      a.click();
      document.body.removeChild(a);
    } else {
      console.error("文件下载失败");
    }
    document.body.removeChild(progressBar);
  };
  xhr.send();
}

在XMLHttpRequest对象上设置setRequestHeader方法,设置Content-Type、Access-Control-Allow-Origin和Access-Control-Allow-Methods请求头,这样就可以跨域下载文件了。需要注意的是,服务器上需要开启CORS支持。

原创文章,作者:小蓝,如若转载,请注明出处:https://www.506064.com/n/158169.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
小蓝小蓝
上一篇 2024-11-19 00:39
下一篇 2024-11-19 00:39

相关推荐

  • JS Proxy(array)用法介绍

    JS Proxy(array)可以说是ES6中非常重要的一个特性,它可以代理一个数组,监听数据变化并进行拦截、处理。在实际开发中,使用Proxy(array)可以方便地实现数据的监…

    编程 2025-04-29
  • vue下载无后缀名的文件被加上后缀.txt,有后缀名的文件下载正常问题的解决

    本文旨在解决vue下载无后缀名的文件被加上后缀.txt,有后缀名的文件下载正常的问题,提供完整的代码示例供参考。 一、分析问题 首先,需了解vue中下载文件的情况。一般情况下,我们…

    编程 2025-04-29
  • 如何在Java中拼接OBJ格式的文件并生成完整的图像

    OBJ格式是一种用于表示3D对象的标准格式,通常由一组顶点、面和纹理映射坐标组成。在本文中,我们将讨论如何将多个OBJ文件拼接在一起,生成一个完整的3D模型。 一、读取OBJ文件 …

    编程 2025-04-29
  • Python中读入csv文件数据的方法用法介绍

    csv是一种常见的数据格式,通常用于存储小型数据集。Python作为一种广泛流行的编程语言,内置了许多操作csv文件的库。本文将从多个方面详细介绍Python读入csv文件的方法。…

    编程 2025-04-29
  • 为什么用cmd运行Java时需要在文件内打开cmd为中心

    在Java开发中,我们经常会使用cmd在命令行窗口运行程序。然而,有时候我们会发现,在运行Java程序时,需要在文件内打开cmd为中心,这让很多开发者感到疑惑,那么,为什么会出现这…

    编程 2025-04-29
  • Python程序文件的拓展

    Python是一门功能丰富、易于学习、可读性高的编程语言。Python程序文件通常以.py为文件拓展名,被广泛应用于各种领域,包括Web开发、机器学习、科学计算等。为了更好地发挥P…

    编程 2025-04-29
  • Python将矩阵存为CSV文件

    CSV文件是一种通用的文件格式,在统计学和计算机科学中非常常见,一些数据分析工具如Microsoft Excel,Google Sheets等都支持读取CSV文件。Python内置…

    编程 2025-04-29
  • Python zipfile解压文件乱码处理

    本文主要介绍如何在Python中使用zipfile进行文件解压的处理,同时详细讨论在解压文件时可能出现的乱码问题的各种解决办法。 一、zipfile解压文件乱码问题的根本原因 在P…

    编程 2025-04-29
  • Python如何导入py文件

    Python是一种开源的高级编程语言,因其易学易用和强大的生态系统而备受青睐。Python的import语句可以帮助用户将一个模块中的代码导入到另一个模块中,从而实现代码的重用。本…

    编程 2025-04-29
  • Python合并多个相同表头文件

    对于需要合并多个相同表头文件的情况,我们可以使用Python来实现快速的合并。 一、读取CSV文件 使用Python中的csv库读取CSV文件。 import csv with o…

    编程 2025-04-29

发表回复

登录后才能评论