Node.js 实现文件上传与进度监听的完整方案
本文详细介绍在 Node.js 环境下实现文件上传及进度监听的多种前端方案,涵盖原生 XMLHttpRequest、jQuery Ajax 以及 Axios。后端基于 Koa 框架,利用 koa-body 中间件处理文件流,并通过 Stream 和 Promise 封装确保大文件上传的性能与稳定性。
Node.js 文件上传与进度监听方案
前言
在文件上传场景中,集成进度条能显著提升用户体验,特别是针对中大型文件。本文旨在展示如何结合 Nodejs 与前端技术实现这一功能。
前端传输数据时,我们将采用 FormData 作为数据载体。
效果
前端实现:多种上传方式对比
前端部分
HTML 部分 和 Js 部分
<input type="file" id="file" />
<!-- 进度条 -->
<progress id="progress" value="0" max="100"></progress>
// 获取 input file 的 dom 对象
const inputFile = document.querySelector('#file');
// 监听 change 事件
inputFile.addEventListener('change', function() {
// 使用 formData 装载 file
const formData = new FormData();
formData.append('file', this.files[0]);
// 上传文件
upload(formData);
})
接下来实现 upload 方法。
使用 XMLHttpRequest 的方式
const upload = ( formData ) => {
const xhr = new XMLHttpRequest();
// 监听文件上传进度
xhr.upload.addEventListener('progress', function(e) {
if (e.lengthComputable) {
// 获取进度
const progress = Math.round((e.loaded * 100) / e.total);
document.querySelector('#progress').setAttribute('value', progress);
}
},false);
// 监听上传完成事件
xhr.addEventListener('load', ()=>{
console.log(':smile:上传完成')
}, false);
xhr.open('post', 'http://127.0.0.1:3000/upload');
xhr.send(formData);
}
使用 jQuery 的 ajax 上传
尽管 jQuery 当前使用量依然庞大,但通过其 ajax 方法监听文件上传进度的实现方式如下:
const upload = ( formData ) => {
$.ajax({
type: 'post',
url: 'http://127.0.0.1:3000/upload',
data: formData,
// 不进行数据处理和内容处理
processData: false,
contentType: false,
// 监听 xhr
xhr: function() {
const xhr = $.ajaxSettings.xhr();
if (xhr.upload) {
xhr.upload.addEventListener('progress', e => {
const { loaded, total } = e;
var progress = (loaded / total) * 100;
document.querySelector('#progress').setAttribute('value', progress);
},
false
);
return xhr;
}
},
success: function(response) {
console.log('上传成功');
}
});
}
使用 axios 上传并监听进度
由于 axios 拥有极高的使用率,利用它来监听文件上传进度更为简便,具体代码如下:
const upload = async ( formData ) => {
let config = {
// 注意要把 contentType 设置为 multipart/form-data
headers: {
'Content-Type': 'multipart/form-data'
},
// 监听 onUploadProgress 事件
onUploadProgress: e => {
const {loaded, total} = e;
// 使用本地 progress 事件
if (e.lengthComputable) {
let progress = loaded / total * 100;
document.querySelector('#progress').setAttribute('value', progress);
}
}
};
const { status } = await axios.post('http://127.0.0.1:3000/upload', formData, config);
if (res.status === 200) {
console.log('上传完成:grinning:');
}
}
后端实现:基于 Koa 的文件处理
Nodejs 部分
后端部分相对简单,主要涉及文件上传逻辑,此处选用 Koa 框架进行实现。
环境搭建及依赖包安装
本项目基于 koa2 版本,需安装以下依赖包:
- koa
- @koa/router: koa 的路由
- @koa/cors:用于跨域
- koa-body: 解析 body 数据
- nodemon: 使用它启动服务,带有热更新
代码部分
const Koa = require('koa');
const Router = require('@koa/router');
const koaBody = require('koa-body');
const path = require('path');
const fs = require('fs');
const cors = require('@koa/cors');
const app = new Koa();
const router = new Router();
router.all('/upload', async ctx => {
// 处理文件上传
const res = await dealFile(ctx);
res && (ctx.body = {
status: 200,
msg: 'complete'
});
});
// 中间件部分
app.use(cors());
app.use(
koaBody({
multipart: true,
formidable: {
maxFileSize: 2000 * 1024 * 1024 //最大2G
}
})
);
app.use(router.routes());
app.use(router.allowedMethods());
app.listen(3000);
dealFile 方法处理上传的文件
出于性能考虑,处理 file 对象时务必使用 stream(流)。
我们需要监听文件流的 end 事件。由于无法直接在事件回调中返回响应(否则会导致 404 错误),因此需使用 Promise 进行封装,并结合 async 和 await 语法处理。
const dealFile = ctx => {
const { file } = ctx.request.files;
const reader = fs.createReadStream(file.path);
const writer = fs.createWriteStream(
// 文件上传到 image 文件夹中
path.resolve(__dirname, './image', file.name)
);
return new Promise((resove, reject) => {
reader.pipe(writer);
reader.on('end', () => {
resove(true);
});
reader.on('error', err => {
throw err;
})
});
};
到这里就全部完成了。
这里注意一下:前端监听文件进度不需要后端有什么特殊处理,后端仅仅是做了文件流的写入而已。
总结
到此这篇关于Nodejs文件上传、监听上传进度的文章就介绍到这了,更多相关Nodejs文件上传、监听上传进度内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!
Java和JavaScript的应用场景分工:后端企业级开发与Web前端交互
2026-11-05 15:57:34
除了浏览器和Node.js,还有哪些轻量级Js脚本运行工具?
2026-11-04 17:38:24
无需后端:用JavaScript实现简单网站的本地数据存储
2026-11-03 23:03:30
Node.js 下载慢或官网打不开怎么办
2026-11-03 18:19:37
JS解析大体积Excel文件内存溢出怎么办
2026-11-03 18:19:37
