傳統表單上傳檔案只能等,畫面會凍結到上傳結束。HTML5 的 XMLHttpRequest 加上 FormData,讓我們可以做到非同步上傳、即時進度條,還能跨域送出。
跨域的前提是伺服器必須回應正確的標頭。在 IIS 的「HTTP 回應標頭」中新增一項 Access-Control-Allow-Origin:


少了這行,Chrome 等瀏覽器會直接以 CORS 政策為由攔下請求,前端連錯誤細節都拿不到。注意:這個標頭是回應標頭,要由伺服器設定,在前端用 xhr.setRequestHeader 設定是無效的(註解中那行就是常見的誤解)。正式環境請把 * 換成明確的來源網域,避免使用 * 搭配 credential。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<meta name="format-detection" content="telephone=no">
<meta name="msapplication-tap-highlight" content="no">
<meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width">
<title>Html5 上傳文件</title>
</head>
<body>
<div class="app">
<h1>Html5 上傳文件測試,帶進度條</h1>
<div>
<input type="file" value="" id="fileInput" name="files" onchange="fileSelected()" />
<div style="margin:30px;">
<input type="button" value="上傳" onclick="uploadFile()" />
</div>
<div style="margin:30px;">
<div id="fileName"></div>
<div id="fileSize"></div>
<div id="fileType"></div>
</div>
<div style="margin:30px;width:500px;height:15px;border:1px solid #aeaeae;">
<div id="progress" style="background:#4cff00;height:15px;width:0%;"></div>
<div id="percentNumber"></div>
</div>
<div style="margin:30px;">
<div id="msg"></div>
</div>
</div>
</div>
<script type="text/javascript">
function fileSelected() {
// 重設狀態顯示
document.getElementById("msg").innerHTML = "";
document.getElementById('percentNumber').innerHTML = '';
document.getElementById("progress").style.width = "0%";
var file = document.getElementById('fileInput').files[0];
if (file) {
var fileSize = 0;
if (file.size > 1024 * 1024)
fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB';
else
fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB';
document.getElementById('fileName').innerHTML = 'Name: ' + file.name;
document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize;
document.getElementById('fileType').innerHTML = 'Type: ' + file.type;
}
}
function uploadFile() {
var fd = new FormData();
fd.append("fileInput", document.getElementById('fileInput').files[0]);
var xhr = new XMLHttpRequest();
xhr.upload.addEventListener("progress", uploadProgress, false);
xhr.addEventListener("load", uploadComplete, false);
xhr.addEventListener("error", uploadFailed, false);
xhr.addEventListener("abort", uploadCanceled, false);
xhr.open("POST", "https://10.0.0.200:9001/Home/Upload"); // 改為自己的伺服器介面
// 跨域標頭必須在 IIS(伺服器端)設定,前端設定無效
// 使用 FormData 時不要手動設定 Content-Type,瀏覽器會自行加上 boundary
xhr.send(fd);
}
function uploadProgress(evt) {
if (evt.lengthComputable) {
var percentComplete = Math.round(evt.loaded * 100 / evt.total);
document.getElementById('percentNumber').innerHTML = percentComplete + '%';
document.getElementById("progress").style.width = percentComplete + "%";
} else {
document.getElementById('percentNumber').innerHTML = '不支持進度計算';
}
}
function uploadComplete(evt) {
// evt.target.responseText 可取得伺服器回應
document.getElementById("msg").innerHTML = "上傳成功";
}
function uploadFailed(evt) {
document.getElementById("msg").innerHTML = "上傳過程中有一個錯誤";
}
function uploadCanceled(evt) {
document.getElementById("msg").innerHTML = "用戶取消了上傳或者瀏覽器刪除了連接";
}
</script>
</body>
</html>
1. FormData 是關鍵。它把 File 物件包裝成 multipart/form-data 格式,後端可以像處理一般表單上傳那樣接收,不必改動既有 API。
2. 不要手動設 Content-Type。註解裡那行 xhr.setRequestHeader("Content-Type", "multipart/form-data") 是常見錯誤——少了 boundary 參數,後端會無法解析表單內容。讓瀏覽器自動產生才是正解。
3. 進度監聽要掛在 xhr.upload 上。掛在 xhr 本身只會在取得回應時觸發,拿不到上傳中的進度。另外 lengthComputable 為 false 時表示瀏覽器無法得知總量,此時只能顯示不確定型態的動畫。
4. 記得處理失敗與取消。範例已綁定 error 與 abort 事件,這在行動網路不穩時尤其重要,否則使用者只會看到進度條卡住不動。
5. 前端檢查不能取代後端驗證。file.type 與副檔名都可以被竄改,實際的型別、大小與內容檢查仍必須在伺服器端進行。
這套 HTML5 上傳方案搭配伺服器端的 CORS 標頭設定,就能實現跨域、非同步、有進度回饋的檔案上傳體驗。若需要更進階的功能(分片上傳、斷點續傳、多檔佇列),可以在這份基礎上加上 File.slice() 與 Content-Range 的處理。