0

0

如何实现JavaScript文件上传_进度条怎样实时显示?

夜晨

夜晨

发布时间:2026-01-05 20:56:03

|

902人浏览过

|

来源于php中文网

原创

最直接的方式是用 xmlhttprequest 监听 upload.onprogress,需在 open() 后、send() 前绑定;onprogress 中通过 e.loaded 和 e.total 计算百分比,但 total 为 0 时无法准确计算。

如何实现javascript文件上传_进度条怎样实时显示?

XMLHttpRequest 监听 upload.onprogress 是最直接的方式

现代浏览器都支持 XMLHttpRequest 的上传事件监听,关键不是发请求,而是把 upload 属性的事件钩子挂上去。注意:必须在调用 open() 之后、send() 之前绑定,否则事件不会触发。

  • XMLHttpRequest.upload 是一个独立对象,专门用于监听上传过程
  • onprogress 回调里能拿到 event.loaded(已上传字节数)和 event.total(总字节数),二者都有才可算百分比
  • 如果后端没返回 Content-Length 或用了分块编码(chunked transfer encoding),event.total 可能为 0,此时无法计算准确进度,只能显示“上传中…”
const xhr = new XMLHttpRequest();
xhr.open('POST', '/upload');
xhr.upload.onprogress = function (e) {
  if (e.lengthComputable) {
    const percent = Math.round((e.loaded / e.total) * 100);
    document.getElementById('progress').value = percent;
  }
};
xhr.send(file);

fetch + ReadableStream 能实现但复杂度高

fetch 本身不提供上传进度回调,强行实现需要手动读取 File 并流式构造请求体,再用 ReadableStream 分段推送。这适合大文件切片上传场景,但日常单文件上传没必要绕这么远。

  • 必须用 file.arrayBuffer()file.stream() 获取原始数据流
  • 需自己维护已发送字节数,并在每段 controller.enqueue() 后更新 UI
  • 服务端必须支持流式接收(如 Node.jsreq.on('data')),否则会出错
  • Chrome 和 Edge 支持较好,Safari 对 file.stream() 的支持仍有限制(例如不支持 Blob 直接转流)

表单提交时 FormData 不影响进度监听逻辑

无论你用 new FormData() 包裹 File 还是直接传 File,只要底层还是走 XMLHttpRequestfetch,进度监听方式不变。重点在于传输层,而不是数据组织方式。

情感家园企业站5.0 多语言多风格版
情感家园企业站5.0 多语言多风格版

一套面向小企业用户的企业网站程序!功能简单,操作简单。实现了小企业网站的很多实用的功能,如文章新闻模块、图片展示、产品列表以及小型的下载功能,还同时增加了邮件订阅等相应模块。公告,友情链接等这些通用功能本程序也同样都集成了!同时本程序引入了模块功能,只要在系统默认模板上创建模块,可以在任何一个语言环境(或任意风格)的适当位置进行使用!

下载
  • FormData.append('file', input.files[0]) 是常见写法,不影响 upload.onprogress
  • 不要在 FormData 里 append 太多字段,否则 event.total 会包含这些字段的字节数,导致进度条前期跳变(尤其文本字段大时)
  • 如果同时上传多个文件,每个 xhr 实例要单独监听,不能共用一个 onprogress

移动端或低版本浏览器要注意 ontimeoutonerror 的兜底

进度条卡在 99% 不动?很可能是网络中断、服务端超时或 CORS 预检失败,但 onprogress 不会告诉你这些。必须配对监听错误状态,否则用户以为还在传。

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

  • xhr.ontimeoutxhr.onerror 必须显式设置,不能只靠 onload
  • 部分安卓 WebView(如微信内置)对 upload.onprogress 触发频率做限制,可能几秒才更新一次,别依赖高频刷新
  • 上传大文件时,建议加个 xhr.timeout = 5 * 60 * 1000,避免长时间假死

进度条能显示的前提,是服务端响应头里有明确的 Content-Length,且前端没在请求头里误删 Content-Length(比如用 fetch 时手动设了空 headers)。这点容易被忽略,但一出问题就全盘失效。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
chrome什么意思
chrome什么意思

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

1056

2023.08.11

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

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

837

2023.11.06

edge是什么浏览器
edge是什么浏览器

Edge是一款由Microsoft开发的网页浏览器,是Windows 10操作系统中默认的浏览器,其目标是提供更快、更安全、更现代化的浏览器体验。本专题为大家提供edge浏览器相关的文章、下载、课程内容,供大家免费下载体验。

1724

2023.08.21

IE浏览器自动跳转EDGE如何恢复
IE浏览器自动跳转EDGE如何恢复

ie浏览器自动跳转edge的解决办法:1、更改默认浏览器设置;2、阻止edge浏览器的自动跳转;3、更改超链接的默认打开方式;4、禁用“快速网页查看器”;5、卸载edge浏览器;6、检查第三方插件或应用程序等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

397

2024.03.05

如何解决Edge打开但没有标题的问题
如何解决Edge打开但没有标题的问题

若 Microsoft Edge 浏览器打开后无标题(窗口空白或标题栏缺失),可尝试以下方法解决: 重启 Edge:关闭所有窗口,重新启动浏览器。 重置窗口布局:右击任务栏 Edge 图标 → 选择「最大化」或「还原」。 禁用扩展:进入 edge://extensions 临时关闭插件测试。 重置浏览器设置:前往 edge://settings/reset 恢复默认配置。 更新或重装 Edge:检查最新版本,或通过控制面板修复

1034

2025.04.24

length函数用法
length函数用法

length函数用于返回指定字符串的字符数或字节数。可以用于计算字符串的长度,以便在查询和处理字符串数据时进行操作和判断。 需要注意的是length函数计算的是字符串的字符数,而不是字节数。对于多字节字符集,一个字符可能由多个字节组成。因此,length函数在计算字符串长度时会将多字节字符作为一个字符来计算。更多关于length函数的用法,大家可以阅读本专题下面的文章。

954

2023.09.19

go语言 数组和切片
go语言 数组和切片

本专题整合了go语言数组和切片的区别与含义,阅读专题下面的文章了解更多详细内容。

53

2025.09.03

append用法
append用法

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

348

2023.10.25

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

共58课时 | 6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

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

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