JavaScript 异步图片上传实战:FormData 与 XMLHttpRequest 详解
作者:青柠时间:2026-10-22 10:23:33浏览:168
本文通过具体代码实例,详细讲解如何利用 JavaScript 实现异步图片上传。内容涵盖 HTML 表单配置、FormData 对象的创建与文件添加,以及使用 XMLHttpRequest 发送请求并监听上传进度的完整流程。
HTML 表单配置与测试准备
首先查看 HTML 代码中实现 form 提交的部分。在测试过程中,需要将 test 的 URL 替换为您自己的地址,或者直接编写一个本地地址进行测试。
HTML 代码示例如下:
<form id="uploadForm" action="http://storage.test.com/file/upload" method="post" enctype="multipart/form-data">
<input type="hidden" name="key" id="key" value="VTZ18HM64#D_L3WX" />
<input type="file" name="uploadFiles" value="" id="fileImage" multiple='multiple' />
<div class="upload_submit">
<button type="button" id="fileSubmit" class="upload_btn">保存</button>
</div>
</form>
JavaScript 上传逻辑实现
JavaScript 代码逻辑如下:
var Fileupload = {
fileInput: $("#fileImage").get(0),
dragDrop: $("#fileDragArea").get(0),
upButton: $("#fileSubmit").get(0),
url: $("#uploadForm").attr("action"),
})(),
//文件上传
funUploadFile: function() {
var self = this;
for (var i = 0, file; file = this.fileFilter[i]; i++) {
(function(file) {
var xhr = new XMLHttpRequest();
if (xhr.upload) {
// 上传中
xhr.upload.addEventListener("progress", function(e) {
self.onProgress(file, e.loaded, e.total);
}, false);
// 文件上传成功或是失败
xhr.onreadystatechange = function(e) {
if (xhr.readyState == 4) {
if (xhr.status == 200) {
self.onSuccess(JSON.parse(xhr.responseText));
self.funDeleteFile(file);
if (!self.fileFilter.length) {
//全部完毕
self.onComplete();
}
} else {
self.onFailure(file, xhr.responseText);
}
}
};
//准备FormData对象
var myForm = document.getElementById('uploadForm');
//将文件放入FormData对象中
formData = new FormData(myForm);
// 开始上传
xhr.open("POST", self.url, true);
xhr.send(formData);
}
})(file);
}
},
init: function() {
var self = this;
//上传按钮提交
if (this.upButton) {
console.log('提示: 当前存储服务器地址', this.url)
this.upButton.addEventListener("click", function(e) {
self.funUploadFile(e);
}, false);
}
self.bindEvent();
}
};
Fileupload = $.extend(Fileupload);
Fileupload.init();
利用 FormData 进行异步文件上传。
<input type="file" id="file">
FormData 对象创建与文件添加
第一步,创建 FormData 对象并将待上传的文件放入其中。
//准备FormData对象
var formData = new FormData(),
uploadFile = document.getElementById('file');
//将文件放入FormData对象中
formData.append('file', uploadFile.files[0]);
XMLHttpRequest 发送与进度监听
第二步,通过 XMLHttpRequest 发送 FormData 数据至服务器,从而完成文件上传操作。
//创建xhr对象
var xhr = new XMLHttpRequest();
//监听文件上传进度
xhr.upload.onprogress = function(evt){
//lengthComputabel: 文件长度是否可计算
if(evt.lengthComputable){
//evt.loaded: 已下载的字节数
//evt.total: 文件总字节数
var percent = Math.round(evt.loaded*100/evt.total);
console.log(percent);
}
}
//监听文件传输开始
xhr.onloadstart = function(evt){
xhr.abort() //终止上传
}
//监听ajax成功完成事件
xhr.onload = function(evt){
...
}
//监听ajax错误事件
xhr.onerror = function(evt){
...
}
//监听ajax被中止事件
xhr.onabort = function(evt){
...
}
//监听传输结束事件: 不管成功或者失败都会触发
xhr.onloaded = function(evt){
...
}
//*发起ajax请求数据
xhr.open('POST', '/url', true);
xhr.send(formData);
作者最新文章
ES6模块化中js文件怎么用import和export交互
2026-11-05 17:00:48
JS读取本地文件时报错或无响应的常见原因
2026-11-05 16:32:31
let、const与var的区别:JavaScript变量声明最佳实践
2026-11-05 14:16:38
JS中直接定义静态二维数组的字面量写法
2026-11-05 14:16:08
JS 怎么查找字符串中所有匹配项的位置
2026-11-05 14:15:53
