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 的具体应用案例。如需了解更多相关技术细节,建议查阅本站往期文章或继续浏览后续内容,感谢支持。

作者最新文章