如何使用JavaScript实现文件上传功能_JavaScript如何读取用户本地文件
发布时间 - 2026-01-07 00:00:00 点击率:次必须通过用户主动触发的获取File对象,不可脚本自动调起;其files属性返回只读FileList,File继承Blob;读取用FileReader(禁用readAsDataURL处理大文件);上传用FormData配合fetch;浏览器禁止访问真实路径或本地文件系统。
用 input[type="file"] 获取用户选择的文件对象
浏览器中读取本地文件的前提是用户主动触发选择,不能脚本自动调起。必须通过 元素,且需用户点击操作(如点击、空格键、回车),否则现代浏览器会静默拒绝。
获取到的不是路径字符串,而是 FileList 对象,里面每个项都是 File 实例(继承自 Blob):
const input = document.querySelector('input[type="file"]'); input.addEventListener('change', (e) => { const file = e.target.files[0]; // 用户选中的第一个文件 if (!file) return; console.log(file.name); // 文件名 console.log(file.size); // 字节数 console.log(file.type); // MIME 类型(可能为空) });
-
e.target.files是只读的FileList,不可修改或赋值 - 用户取消选择时,
e.target.files.length为0,不会返回null - 多选需加
multiple属性,但 iOS Safari 对该属性支持不稳定 -
file.type不可靠——浏览器仅根据扩展名或头部推测,可被伪造
用 FileReader 读取文件内容(文本/二进制)
FileReader 是唯一标准方式,在主线程解析文件内容。它不发送网络请求,纯前端处理,适合预览、校验、转 Base64 等场景。
注意:大文件(如 >100MB)容易导致内存暴涨甚至页面卡死,应避免直接 readAsDataURL;优先用 readAsArrayBuffer 或流式分块读取。
const reader = new FileReader();
reader.onload = (e) => {
const content = e.target.result; // 根据 read 方法不同,类型可能是 string / ArrayBuffer
console.log(content);
};
reader.onerror = () => {
console.error('读取失败:', reader.error?.message);
};
// 可选方法:
// reader.readAsText(file, 'UTF-8'); // 返回字符串
// reader.readAsArrayBuffer(file); // 返回 ArrayBuffer
// reader.readAsDataURL(file); // 返回 data:xxx;base64,xxx(慎用!)
- 每次只能处理一个
File,重复调用readAs*会中止前一次操作 -
onload回调中,e.target.result的类型取决于所用的readAs*方法 - 读取二进制内容后,如需转字符串,用
new TextDecoder().decode(arrayBuffer),别依赖readAsText的编码参数(某些浏览器忽略)
用 FormData + fetch 上传文件到服务器
上传本质是 HTTP POST 请求,把文件作为表单字段发给后端。推荐用 FormData 构造请求体,它能自动设置正确的 Content-Type: multipart/form-data 边界头。
不要手动拼接 multipart 数据,也不要试图把 File 转成 JSON 发送——后端无法解析。
const file = input.files[0];
if (!file) return;
const formData = new FormData();
formData.append('upload', file); // 字段名 'upload' 需与后端约定
formData.append('meta', JSON.stringify({ // 可附加其他字段
filename: file.name,
size: file.size
}));
fetch('/api/upload', {
method: 'POST',
body: formData // 不要设 headers.Content-Type,浏览器会自动设置
})
.then(r => r.json())
.then(console.log)
.catch(console.error);
-
FormData.append()第二个参数可以是File、Blob或字符串;第三个参数可指定文件名(覆盖原始file.name) - 若后端要求字段名带数组语法(如
files[]),直接写成formData.append('files[]', file)即可 - 上传进度监听需用
XMLHttpRequest.upload.onprogress,fetch原生不支持(可用ReadableStream分块读取模拟,但复杂度高)
常见错误和绕不过去的限制
很多“读取本地文件”的需求其实混淆了安全边界。浏览器禁止 JS 直接访问任意路径,这是硬性策略,不是 API 缺失。
- 试图用
fs.readFile或require('fs')—— 这是 Node.js API,在浏览器环境根本不存在 - 用
file://协议打开 HTML 页面后读取同目录文件 —— Chrome/Firefox 默认禁用跨源请求,会报CORS或SecurityError - 用
URL.createObjectURL(file)后再fetch()该 URL —— 这只是内存引用,不是真实路径,且必须在revoke前使用,否则泄漏 - 期望获得用户硬盘上的绝对路径(如
C:\xxx\yyy.jpg)—— 浏览器永远只返回C:\fakepath\yyy.jpg或空字符串,这是隐私保护强制行为
真正需要离线读写本地文件的场景(比如桌面应用),应该用 Electron、Tauri 或 WebKit 的 File System Access API(目前仅 Chromium 支持,且需用户手动授权)。普通网页做不到。
# javascript
# java
# html
# js
# 前端
# node.js
# json
# node
# 编码
# 浏览器
# app
# 字节
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
Gemini怎么用新功能实时问答_Gemini实时问答使用【步骤】
如何基于PHP生成高效IDC网络公司建站源码?
详解免费开源的.NET多类型文件解压缩组件SharpZipLib(.NET组件介绍之七)
Laravel如何使用缓存系统提升性能_Laravel缓存驱动和应用优化方案
百度浏览器ai对话怎么关 百度浏览器ai聊天窗口隐藏
Laravel如何与Pusher实现实时通信?(WebSocket示例)
Laravel如何使用Guzzle调用外部接口_Laravel发起HTTP请求与JSON数据解析【详解】
教你用AI润色文章,让你的文字表达更专业
如何快速生成凡客建站的专业级图册?
Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程
Win11怎么关闭资讯和兴趣_Windows11任务栏设置隐藏小组件
如何在浏览器中启用Flash_2025年继续使用Flash Player的方法【过时】
Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控
laravel怎么为API路由添加签名中间件保护_laravel API路由签名中间件保护方法
Laravel怎么实现微信登录_Laravel Socialite第三方登录集成
Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道
武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛,就是里面都是武汉人的?
Laravel如何创建自定义中间件?(Middleware代码示例)
昵图网官网入口 昵图网素材平台官方入口
Laravel如何实现多对多模型关联?(Eloquent教程)
如何用ChatGPT准备面试 模拟面试问答与职场话术练习教程
如何在阿里云虚拟主机上快速搭建个人网站?
在centOS 7安装mysql 5.7的详细教程
轻松掌握MySQL函数中的last_insert_id()
javascript中对象的定义、使用以及对象和原型链操作小结
HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】
jQuery validate插件功能与用法详解
如何在Windows 2008云服务器安全搭建网站?
使用PHP下载CSS文件中的所有图片【几行代码即可实现】
原生JS实现图片轮播切换效果
Windows家庭版如何开启组策略(gpedit.msc)?(安装方法)
Laravel如何为API生成Swagger或OpenAPI文档
Laravel API资源(Resource)怎么用_格式化Laravel API响应的最佳实践
JS中对数组元素进行增删改移的方法总结
Bootstrap CSS布局之列表
Win11摄像头无法使用怎么办_Win11相机隐私权限开启教程【详解】
Laravel中Service Container是做什么的_Laravel服务容器与依赖注入核心概念解析
Android 常见的图片加载框架详细介绍
Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】
iOS正则表达式验证手机号、邮箱、身份证号等
Google浏览器为什么这么卡 Google浏览器提速优化设置步骤【方法】
Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门
Laravel怎么连接多个数据库_Laravel多数据库连接配置
如何在VPS电脑上快速搭建网站?
专业商城网站制作公司有哪些,pi商城官网是哪个?
如何用wdcp快速搭建高效网站?
Laravel怎么写单元测试_PHPUnit在Laravel项目中的基础测试入门
如何用免费手机建站系统零基础打造专业网站?
使用豆包 AI 辅助进行简单网页 HTML 结构设计
laravel怎么配置Redis作为缓存驱动_laravel Redis缓存配置教程


'input[type="file"]');
input.addEventListener('change', (e) => {
const file = e.target.files[0]; // 用户选中的第一个文件
if (!file) return;
console.log(file.name); // 文件名
console.log(file.size); // 字节数
console.log(file.type); // MIME 类型(可能为空)
});