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

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

胖枫吖_6664

胖枫吖_6664

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

|

478人浏览过

|

来源于php中文网

原创

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

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

用 <input type="file"> 拿到用户选中的文件

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

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

  • multiple 属性允许选多个文件:<input type="file" 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 保持一致(后端按同名字段接收数组):

前端开发
前端开发

ys-agent 前端(frontend/)功能迭代的工程规范守门 skill。当任何 agent 接到 ys-agent 前端相关任务时——新增页面、新增组件、加 API、加 Pinia store、改路由、写 mock、调整布局、修改样式、对接后端接口、迁移 demo 代码、做主题、加权限、写公共组件、做数据可视化、做表单、做弹窗、做表格、做搜索过滤、调 Element Plus 用法、做响应式、做性能优化,或仅仅是在 frontend/ 目录下编辑任何 .vue / .ts / .scss / .c

下载

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

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

用 fetch 发起上传并监听进度

fetch 本身不支持上传进度,得靠 XMLHttpRequest 的 upload.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.js 或 canvas 旋转修复,不在上传流程内处理

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

相关文章

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

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

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixPix
PixPix Hot

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

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

相关专题

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

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

2215

2023.08.07

json是什么
json是什么

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

3502

2023.08.23

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

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

1176

2023.10.13

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

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

4039

2025.09.10

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

14466

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

1705

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

3997

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

6161

2024.03.01

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.4万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习

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

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