原生H5实现文件下载

环境说明

  • 前端
    • axios
    • 原生JavaScript
  • 后端
    • node.js:v16.19.1
    • express:4.18.2(接口快速开发框架)
    • cors:2.8.5(处理跨域的包)

原理

  • 通过XHR或axios,发送文件下载请求,以axios为例,设置responseTypeblob,表示是文件下载请求
  • 点击按钮,发送文件下载请求,通过document.createElement("a"),动态创建一个a标签,但不要添加到页面上
  • 设置a标签的href属性和download属性,href属性设置为文件下载的接口地址,download属性设置文件下载后的文件名
  • 调用a标签对象的click方法,模拟a标签点击

前端

编写页面(index.html)

  • 点击下载按钮,触发下载请求,选择保存的磁盘位置,即可发起下载
<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>下载功能</title>
</head>

<body>
  <!-- 直接这么写,不是下载,而是跳转!!  -->
  <!-- <a href="https://cdn-getuigw.getui.com/getuipush.pdf">下载吧</a> -->

  <!-- 这样写可以下载 -->
  <!-- <a  download="aaa.pdf" href="http://localhost:4000/file">下载吧</a> -->

  <!-- 
    1、前端要获取到后台生成文件 
    2、让前端浏览器触发下载行为,利用a标签自身的能力来实现 
      - 创建一个新的a标签 
      - 设置a标签的关键属性
        - 设置href属性,等于要下载文件资源 
        - 设置download属性,表示要下载 
      - 模拟a标签的点击行为 
   -->
  <button>下载</button>
  <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
  <script>
    const button = document.querySelector("button");
    button.addEventListener('click', async function (e) {
      // 使用axios,后台发起请求,请求文件资源 
      const result = await axios({
        url: "http://127.0.0.1:4000/file",
        // 请求文件,设置期望后端返回数据类型,blob
        // b:binary,也就是二级制流
        // l:large,大
        // o:object,对象
        // 所以,blob:大文件
        responseType: "blob"
      });

      // 前端模拟a标签
      const a = document.createElement("a");
      // 传入二进制流,返回可以访问到的,字符串类型的url
      const url = URL.createObjectURL(result.data);
      // 设置url为文件下载路径
      a.href = url;
      // 设置下载的文件名
      a.download = "abc.txt";
      // 模拟a标签点击
      a.click();
    });
  </script>
</body>

</html>

后端

准备本地文件

data目录,1.txt 文件

我是测试文本

编写接口(index.js)

  • 启动一个web服务端,监听4000端口。
  • 再编写一个file接口,接口地址:http://127.0.0.1:4000/file
  • 读取本地data目录下的1.txt,并返回文件流
// 1 引入包
const express = require("express")
const cors = require("cors")
const fs = require("fs")
const path = require("path")

// Web开发框架
const app = express()

// 跨域资源共享,解决跨域问题
app.use(cors())

// 2 定义接口 路由
app.get("/file", (req, res) => {
  console.log('接收到文件下载请求...');

  // 文件路径
  const filePath = path.join(__dirname, "./data/1.txt")
  // 同步读取文件
  const file = fs.readFileSync(filePath)
  // 返回二进制文件流
  res.send(file)

  console.log("响应文件结束...");
})

// 3 开启监听
const port = 4000
app.listen(port, () => {
  console.log(`启动成功,监听${port}端口...`);
})
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容