Ajax 文件上传进度监听:jQuery 与原生 XMLHttpRequest 实现详解
作者:异步漫步时间:2026-10-24 15:32:28浏览:663
本文详细解析如何在文件上传过程中监听进度。通过 jQuery 的 $.ajax 配置 xhr 回调,以及原生 XMLHttpRequest 对象绑定 onprogress 事件,分别演示了如何计算并更新上传百分比。代码包含完整的 HTML 结构与 JavaScript 逻辑,适用于需要实时反馈上传状态的前端开发场景。
使用 jQuery 的 $.ajax 方法实现文件上传进度监听,关键在于配置 xhr 回调函数。在该函数中获取 XMLHttpRequest 实例,并为其绑定 onprogress 事件监听器。通过计算已上传字节数与总字节数的比例,动态更新界面上的进度条宽度,从而直观展示上传进度。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<title>Document</title>
<script src="./libs/jquery/jquery.js"></script>
<style>
div {
width: 0%;
height: 20px;
background-color: #f00;
/* transition: all 0.2s; */
}
</style>
</head>
<body>
<div></div>
<input type="file" />
<script>
$(function() {
// 用户选择好文件之后单击弹出层的“打开”按钮的触发事件是:change
$('input').on('change', function() {
// 1.收集文件数据
let myfile = $('input')[0].files[0]
let formdata = new FormData()
formdata.append('file_data', myfile)
// 2.发起ajax请求
$.ajax({
url: 'http://127.0.0.1:3001/uploadFile',
type: 'post',
data: formdata,
processData: false,
contentType: false,
xhr: function() {
let newxhr = new XMLHttpRequest()
// 添加文件上传的监听
// onprogress:进度监听事件,只要上传文件的进度发生了变化,就会自动的触发这个事件
newxhr.upload.onprogress = function(e) {
console.log(e)
let percent = (e.loaded / e.total) * 100 + '%'
$('div').css('width', percent)
}
return newxhr
},
success: function(res) {
console.log(res)
},
dataType: 'json'
})
})
})
</script>
</body>
</html>
采用原生 JavaScript 实现时,需手动创建 XMLHttpRequest 对象。在 open 方法指定请求方式后,监听 xhr.upload.onprogress 事件。在事件处理函数中,利用 event.loaded 和 event.total 计算上传百分比,并通过修改 DOM 元素的 CSS 宽度属性来驱动进度条动画展示。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<title>Document</title>
<script src="./libs/jquery/jquery.js"></script>
<style>
div {
width: 0%;
height: 20px;
background-color: #f00;
/* transition: all 0.2s; */
}
</style>
</head>
<body>
<div></div>
<input type="file" />
<script>
$(function() {
// 用户选择好文件之后单击弹出层的“打开”按钮的触发事件是:change
$('input').on('change', function() {
// 1.收集文件数据
let myfile = $('input')[0].files[0]
let formdata = new FormData()
formdata.append('file_data', myfile)
let xhr = new XMLHttpRequest()
xhr.open('post', 'http://127.0.0.1:3001/uploadFile')
// 细节1:文件上传,如果使用fromdata,则不要设置请求头
xhr.upload.onprogress = function(e) {
console.log(e)
let percent = (e.loaded / e.total) * 100 + '%'
$('div').css('width', percent)
}
// 细节2:send中可以直接传递formdata
xhr.send(formdata)
})
})
</script>
</body>
</html>
以上介绍了 Ajax 文件上传进度监听中 upload.onprogress 的具体应用案例。如需了解更多相关技术细节,建议查阅本站往期文章或继续浏览后续内容,感谢支持。
作者最新文章
D3.js 比例尺与坐标轴的配置详解
2026-11-05 16:54:46
JavaScript怎么遍历对象的Symbol键和不可枚举属性
2026-11-05 13:13:39
封装一个健壮的JS字符串判空工具函数
2026-11-05 12:16:14
JavaScript合并数组的三种常用方法:concat、扩展运算符与push
2026-11-05 11:22:29
JavaScript立即执行函数(IIFE)是什么及基本语法
2026-11-05 10:51:19
