0

0

HTML5FormData上传进度显示_HTML5XMLHttpRequest上传监听百分比方法【指南】

星夢妙者

星夢妙者

发布时间:2026-02-25 19:47:02

|

414人浏览过

|

来源于php中文网

原创

html5formdata上传进度显示_html5xmlhttprequest上传监听百分比方法【指南】

XMLHttpRequest.upload.onprogress 不触发?检查是否漏了 open() 之后、send() 之前绑定

常见错误是把 onprogress 放在 open() 前,或绑在 onload 之后——这时监听器根本没注册上。XMLHttpRequest 的上传事件只在 send() 调用后才可能触发,且必须在 send() 前完成绑定。

  • upload 对象仅对非 GET 请求有效(POST/PUT 等),GET 请求无上传体,onprogress 永远不触发
  • 如果用 FormData 提交但服务端返回 400/500,onprogress 可能只触发 1–2 次就中断,不是 bug,是浏览器提前终止上传
  • 本地 file:// 协议下部分浏览器禁用 upload 事件,务必在 http(s) 服务器环境测试

FormData.append() 传 Blob 还是 File?影响进度精度

File 对象(比如 input.files[0])时,onprogress.loaded.total 是准确的字节数;传普通 Blob(如 new Blob([str]))也行,但若 Blob 由 canvas.toBlob() 或 fetch().then(r => r.blob()) 生成,某些旧版 Chrome 会把 .total 报成 0,导致百分比算成 NaN%

  • 优先用原始 File 对象,避免中间转 Blob
  • 若必须用 Blob,创建时显式传入 type: new Blob([data], {type: 'image/jpeg'}),否则部分浏览器无法正确计算 size
  • 不要用 JSON.stringify() 后 append 进 FormData——那会变成文本上传,体积小、进度跳变快,掩盖真实大文件行为

为什么 onprogress 里 console.log(this.upload.loaded) 总是 0?

因为 this 在事件回调里不指向 XHR 实例,而是全局对象(或 undefined)。直接写 xhr.upload.onprogress = function() { console.log(this.upload) } 必然报错或取不到值。

医真AI+开放平台
医真AI+开放平台

医真AI+ 医学AI开放平台

下载
  • 用箭头函数保持词法作用域:xhr.upload.onprogress = (e) => { console.log(e.loaded, e.total) }
  • 或明确绑定:xhr.upload.onprogress = function(e) { console.log(this.upload.loaded) }.bind(xhr)
  • e.loaded 是已上传字节数,e.total 是预估总大小(等于 File.size),二者都是数字,可直接做除法

移动端 Safari 进度不准?别信 loaded/total,改用时间戳估算

iOS 15–16 的 Safari 对大文件上传的 onprogress 触发频率极低(有时整次上传只触发 2–3 次),且 e.total 偶尔为 0。硬靠它算百分比会卡在 0% 或突然跳到 100%。

立即学习前端免费学习笔记(深入)”;

  • 加个计时器兜底:let start = Date.now(); xhr.upload.onprogress = () => { const elapsed = Date.now() - start; /* 结合已知文件大小和平均速率估算 */ }
  • 对 >10MB 文件,建议分片上传(如每片 2MB),每片单独监听进度,规避单次 upload 事件不可靠问题
  • 不要依赖 onprogress 更新 UI 频率,用 requestAnimationFrame 节流显示,避免频繁重绘卡顿

真正难的不是监听事件,是面对不同内核对同一规范的实现偏差——尤其是 iOS WebKit 和 Android WebView 的 upload 事件行为差异,得靠实际设备+真机调试才能踩准节奏。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

448

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

323

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

986

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

806

2023.11.06

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

552

2023.09.20

append用法
append用法

append是一个常用的命令行工具,用于将一个文件的内容追加到另一个文件的末尾。想了解更多append用法相关内容,可以阅读本专题下面的文章。

348

2023.10.25

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

127

2026.02.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.4万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.8万人学习

CSS教程
CSS教程

共754课时 | 36.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号