讲师中心 微信公众号
AI工具推荐 视频效率加速

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

阿雪姑娘_1436

阿雪姑娘_1436

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

|

454人浏览过

|

来源于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) } 必然报错或取不到值。

使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审
使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审

使用经过文档化的设计技能,从真实的品牌或项目背景中生成HTML原生原型、幻灯片、动态演示、可视化图表和评审流程。

下载
  • 用箭头函数保持词法作用域: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工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

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

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

2255

2023.08.07

json是什么
json是什么

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

3642

2023.08.23

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

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

1216

2023.10.13

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

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

4199

2025.09.10

chrome什么意思
chrome什么意思

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

2886

2023.08.11

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

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

5899

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

4187

2026.03.24

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

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

2378

2023.09.20

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 234人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn