JavaScript中如何实现文件上传_FileAPI使用-js教程-PHP中文网

file api 是文件上传的基础，需配合 xmlhttprequest 或 fetch 使用；通过 input[type="file"] 获取 file 对象，校验大小与类型后，用 formdata 构造请求并发送，支持进度监听与错误处理。

javascript中如何实现文件上传_fileapi使用

JavaScript 中实现文件上传，File API 是基础支撑，但它本身不直接“上传”，而是配合 XMLHttpRequest 或 Fetch API 完成上传逻辑。所谓“FileAPI 使用”，核心是读取、校验、构造并发送文件数据。

获取文件对象：从 input[type="file"] 开始

用户选择文件后，<input type="file"> 的 files 属性返回一个 FileList 对象（类数组），每个项都是 File 实例（继承自 Blob）：

用 input.files[0] 获取第一个文件（单选）；多选则遍历 input.files
File 对象自带属性：name（文件名）、size（字节大小）、type（MIME 类型，如 "image/jpeg"），可用于前端校验
注意：不能直接读取文件路径（出于安全限制），file.path 在浏览器中始终为 ""

校验与预处理：别跳过这一步

上传前建议做轻量校验，提升体验并减少无效请求：

Comet AI 浏览器

下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。

下载

检查 files.length > 0，避免空提交
按 file.size 限制大小（例如 ≤ 5MB）：if (file.size > 5 * 1024 * 1024) { alert("文件不能超过 5MB"); return; }
按 file.type 或文件扩展名（file.name.split('.').pop().toLowerCase()）过滤类型，如只允许 ["jpg", "png", "pdf"]
如需预览图片，可用 URL.createObjectURL(file) 生成临时 URL 绑定到 <img> 标签

构造上传请求：FormData 是关键桥梁

浏览器上传文件必须使用 FormData 对象包装，它能自动设置正确的 Content-Type: multipart/form-data 及边界（boundary）：

创建实例：const formData = new FormData();
追加文件：formData.append("file", file);（服务端接收字段名为 file）
可同时附加其他字段：formData.append("desc", "用户头像"); formData.append("uid", "123");
使用 fetch 上传示例：

fetch("/upload", {
  method: "POST",
  body: formData // 不要设 headers！FormData 会自动生成 Content-Type
})
.then(r => r.json())
.then(data => console.log("上传成功:", data));

监听进度与处理响应

上传大文件时，用户需要感知进度。XMLHttpRequest 支持原生进度事件，Fetch 目前不支持（需流式解析或第三方库）：

用 XMLHttpRequest 可监听 upload.onprogress：

const xhr = new XMLHttpRequest();
xhr.upload.onprogress = e => {
  if (e.lengthComputable) {
    const percent = Math.round((e.loaded / e.total) * 100);
    console.log(`上传中... ${percent}%`);
  }
};
xhr.onload = () => {
  if (xhr.status === 200) console.log("成功", JSON.parse(xhr.responseText));
};
xhr.open("POST", "/upload");
xhr.send(formData);

服务端响应建议返回 JSON（如 { success: true, url: "https://xxx.com/abc.jpg" }），便于前端处理后续逻辑（如显示图片、存入表单字段等）
记得捕获网络错误、超时、服务端业务错误（如 400/500），统一提示用户

基本上就这些。File API 提供了安全可控的文件访问能力，真正上传靠的是和后端约定好的接口 + FormData + 请求发送。不复杂但容易忽略校验和用户体验细节。