大文件上傳最怕的就是一條請求傳到底:中途斷網就得從頭再來,進度條也不好做。分段(分片)上傳的解法是把文件切成若干塊依次上報,服務端再拼接起來。本文整理兩種純前端實現方式。
<form method="POST" name="form" action="/mupload/upload/" enctype="multipart/form-data"> <input type='hidden' name='csrfmiddlewaretoken' value='' /> <input id='file' type='file' name='file' onchange="" /> <input id='button' name='submit' type='button' value="上傳" onclick="chunk_upload(this)" /> </form>
var fileSplitSize = 1024 * 1024; // 每片 1MB
var start = 0, end = 0;
var i = 0;
function chunk_upload(button) {
var xmlhttp = new XMLHttpRequest();
xmlhttp.open("POST", "/chunk_upload/upload/", false);
xmlhttp.setRequestHeader("X-CSRFToken", button.form['csrfmiddlewaretoken'].value);
var f = button.form;
var file = f['file']['files'][0];
var size = file.size;
end = start + fileSplitSize;
if (end > size) {
i = -1;
end = size;
} else {
i += 1;
}
// 按大小切割文件片段
var blob = file.slice(start, end);
xmlhttp.setRequestHeader('charset', 'utf-8');
xmlhttp.setRequestHeader("start", start);
xmlhttp.setRequestHeader("end", end);
xmlhttp.send(blob);
if (xmlhttp.status == 200) {
if (end == size) {
alert(xmlhttp.responseText);
} else {
alert("上傳完成第 " + i + " 段");
start = end;
chunk_upload(button); // 遞歸上傳下一段
}
} else {
alert("上傳錯誤");
chunk_upload(button);
}
}
整個流程可以概括為五步:
xmlhttp.setRequestHeader("end", end);start = end; chunk_upload(button);最需要小心的是 start、end 與 file.size 三者的大小關係:end 必須以 size 為上限截斷,否則最後一片會越界。
如果不想手動管理分片,可以直接用 FormData 上傳整個文件,同時借助 upload.onprogress 匯報進度。下面把它封裝成一個可複用的函數:
;(function (window, document) {
var myUpload = function (option) {
var file,
fd = new FormData(),
xhr = new XMLHttpRequest(),
loaded, tot, per, uploadUrl, input;
input = document.createElement("input");
input.setAttribute('id', "myUpload-input");
input.setAttribute('type', "file");
input.setAttribute('name', "files");
input.click();
uploadUrl = option.uploadUrl;
callback = option.callback;
uploading = option.uploading;
beforeSend = option.beforeSend;
input.onchange = function () {
file = input.files[0];
// 可在發送前做文件校驗
if (beforeSend instanceof Function) {
if (beforeSend(file) === false) { return false; }
}
fd.append("files", file);
xhr.onreadystatechange = function () {
if (xhr.readyState == 4 && xhr.status == 200) {
if (callback instanceof Function) {
callback(xhr.responseText);
}
}
};
// 偵查當前附件上傳情況,約 0.05~0.1 秒回調一次
xhr.upload.onprogress = function (evt) {
loaded = evt.loaded;
tot = evt.total;
per = Math.floor(100 * loaded / tot);
if (uploading instanceof Function) { uploading(per); }
};
xhr.open("post", uploadUrl);
xhr.send(fd);
};
};
window.myUpload = myUpload;
})(window, document);
// 用法
myUpload({
uploadUrl: "/async/myUpload.php", // 接收文件的地址
// 選擇文件後、發送前的自定義邏輯,可用於校驗與初始化進度條
beforeSend: function (file) {},
// 上傳完成回調
callback: function (res) {},
// 上傳過程中的進度(已上傳百分比)
uploading: function (per) {}
});
分段上傳的優勢在於可續傳、可並發、便於做真正的進度與斷點恢復,代價是服務端需要提供合併接口,並妥善處理分片順序與暫存清理。
FormData 整體上傳則簡單得多,配合 onprogress 就能畫出可信的進度條,適合中小文件。需要注意的是 xhr.upload.onprogress 只在 upload 對象上觸發,很多人誤把它掛在 xhr 上,結果進度條一直不動。
實際項目中常見的做法是:先按大小設定閾值,小文件直接整體上傳,超過閾值才切換到分片模式,兼顧簡單與可靠。