0

0

javascript如何实现文件上传_怎样处理用户选择的文件

幻影之瞳

幻影之瞳

发布时间:2026-01-13 19:47:02

|

458人浏览过

|

来源于php中文网

原创

监听input file的change事件获取FileList,用FormData构建数据体并用XMLHttpRequest上传,注意校验空文件、类型限制、进度监听及响应解析。

javascript如何实现文件上传_怎样处理用户选择的文件

拿到用户选中的文件

核心是监听 change 事件,从 event.target.files 中读取 FileList 对象。它不是数组,但可以用 [...files] 展开或用索引访问(比如 files[0])。

注意:直接读取 files 是同步的,不涉及异步加载——这只是浏览器提供的本地引用,还没上传。

  • multiple 属性允许选多个文件:
  • accept 可限制类型(如 accept="image/*,.pdf"),但只是提示,不能替代服务端校验
  • files.length === 0 表示用户取消选择,需主动判断,否则容易误触发上传逻辑

FormData 构建上传数据体

这是最常用、兼容性好、支持二进制和字段混合提交的方式。不要手动拼 JSON.stringify() 或设置 Content-Type: application/json——那样传不了文件。

const formData = new FormData();
formData.append('file', file); // 单个文件
formData.append('description', '用户上传的截图'); // 额外字段
formData.append('category', 'report');

如果传多个文件,可循环追加,name 保持一致(后端按同名字段接收数组):

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

Stenography
Stenography

一个AI驱动的代码库API

下载
for (const file of files) {
  formData.append('files', file); // 注意 name 是 'files',不是 'file[]'
}
  • 不用手动设 Content-Type 头——fetchXMLHttpRequest 发送 FormData 时会自动设置为 multipart/form-data 并带上正确 boundary
  • 避免对 FormData 再 JSON 序列化,否则会报错或传空
  • 某些旧版 Safari 对大文件 append 有性能问题,可考虑分片前先做大小检查

fetch 发起上传并监听进度

fetch 本身不支持上传进度,得靠 XMLHttpRequestupload.onprogress,或者用 ReadableStream + TransformStream(现代方案,但兼容性有限)。多数场景下,用 XMLHttpRequest 更稳妥。

const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (e) => {
  if (e.lengthComputable) {
    const percent = (e.loaded / e.total) * 100;
    console.log(`上传中:${percent.toFixed(1)}%`);
  }
};
xhr.onload = () => {
  if (xhr.status >= 200 && xhr.status < 300) {
    console.log('上传成功', JSON.parse(xhr.responseText));
  }
};
xhr.open('POST', '/api/upload');
xhr.send(formData);
  • xhr.upload 是上传专用对象,xhr.onprogress 是下载进度,别混淆
  • 服务端返回非 2xx 状态码时,xhr.status 仍可读,但 xhr.onerror 不一定触发(比如 400、500 属于“成功收到响应”,走 onload
  • 若需 Abort,用 xhr.abort()fetch 则需 AbortController,但无法获知上传进度

处理常见错误和边界情况

用户选了文件不等于能上传成功。以下问题必须在前端拦截或提示:

  • file.size === 0:空文件,可能是误点或生成失败,建议直接拒绝
  • file.type 为空字符串:部分本地文件(如桌面拖入的无扩展名文件)可能无 MIME 类型,不能只依赖它校验格式
  • 超大文件未分片:直接传几百 MB 易被浏览器中断或服务端拒绝,应提前 if (file.size > 50 * 1024 * 1024) 提示分卷上传
  • 重复上传同一文件:可用 file.name + file.size + file.lastModified 做简易指纹,避免误操作重发
  • 移动端 capture 拍照后可能旋转异常:这不是上传问题,但常被一起遇到——需用 EXIF.jscanvas 旋转修复,不在上传流程内处理

真正上传失败的原因往往藏在响应体里,比如后端返回 {"code":401,"msg":"token expired"},前端要解析 responseText 而不只是看状态码。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

552

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

374

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

731

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

477

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

394

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

990

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

656

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

551

2023.09.20

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

3

2026.01.13

热门下载

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

精品课程

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

共58课时 | 3.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.2万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

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

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