曾經從網上下載一個 jQuery 的 AJAX 上傳外掛,左側是上傳分類選單。原本規劃是依分類在伺服端建立不同資料夾存放檔案,因此需要把分類名稱當參數送到後端。分類資料由資料庫讀出、以 repeater 產生,點擊某個分類時加上選中樣式,同時把名稱存進變數 uploadCatlog。
參數確實能取到、也確實傳給了後端,但只有第一次是正確的,之後每次上傳帶的都是第一次的分類值,完全不更新。更奇怪的是,同一個變數在 onComplete 回呼中讀出來的值是正確的、已經更新過了。
問題出在外掛的實例化時機。原本的程式把 new AjaxUpload(...) 寫在 btnUpload.click 裡面,但 data 選項是在建立實例的那一刻被讀取並保存下來的。也就是說,第一次點擊時實例被建立,data: { "catlog": uploadCatlog } 的當時值被固定住;後續再點擊,雖然 uploadCatlog 變了,實例卻沒有重建,data 裡存的仍是舊值。而 onComplete 是在函式閉包中讀取變數本身,自然拿得到最新值。
這是一個典型的「值在建立時被求值,而非呼叫時」的陷阱。
$(function () {
var uploadCatlog;
$("#menu .nav5").addClass("menu_active").siblings().removeClass("menu_active");
$("#kllst li").click(function () {
$(this).addClass("currentli").siblings().removeClass();
uploadCatlog = $(this).text();
});
var btnUpload = $('#upload');
var status = $('#status');
btnUpload.click(function () {
if (uploadCatlog == undefined) {
status.text("必須先選擇上傳文件的類別!").addClass('error');
return false;
}
new AjaxUpload(btnUpload, {
action: 'handler/doUpload.ashx',
name: 'uploadfile',
onSubmit: function (file, ext) {
if (!(ext && /^(doc|docx|xls)$/.test(ext))) {
status.text('只支持 WORD、EXCEL 格式上傳!').addClass('error');
return false;
}
status.text('正在上傳,請稍候...');
},
data: { "catlog": uploadCatlog }, // 這裡的值在建立實例時就固定了
onComplete: function (file, response) {
status.text('').removeClass('error');
if (response == "success") {
var fimgtype;
if (file.indexOf(".doc") != -1 || file.indexOf(".docx") != -1) { fimgtype = "word"; }
if (file.indexOf(".xls") != -1) { fimgtype = "excel"; }
$('<li></li>').appendTo('#files')
.html('<img src="images/' + fimgtype + '.png" alt="" /><br />['
+ uploadCatlog + ']' + file)
.addClass('success');
} else {
$('<li></li>').appendTo('#files').text(file).addClass('error');
}
}
});
});
});
外掛本身提供了 setData() 方法,正是為此設計。在 onSubmit 回呼中呼叫它,就能在每次上傳前寫入最新的參數:
// 建立實例後保存參考
var upload = new AjaxUpload('#div_id', { action: 'upload.php' });
// 例如使用者選擇了某些東西,動態設定參數
upload.setData({ "catlog": uploadCatlog });
套回原本的結構,改動只有兩處:把實例建立移到 click 之外只跑一次,並在 onSubmit 中補上 setData。
每次點擊都重建實例,讓 data 重新求值。這是最直白的修法,代價是重複建立物件。
把參數寫進表單的隱藏欄位,讓外掛從表單序列化時一併帶走,這樣就不依賴 data 選項的靜態性。
改用 FormData。現代做法直接避開這類外掛的狀態問題:
$('#uploadForm').on('submit', function (e) {
e.preventDefault();
var fd = new FormData();
fd.append('uploadfile', $('#fileInput')[0].files[0]);
fd.append('catlog', uploadCatlog); // 每次送出時才取值
$.ajax({
url: 'handler/doUpload.ashx',
type: 'POST',
data: fd,
processData: false,
contentType: false,
success: function (res) { /* 處理回應 */ }
});
});
FormData 在呼叫 $.ajax 的當下才組裝內容,天然就不會有「值被提前固定」的問題;搭配 processData: false 與 contentType: false 讓瀏覽器自行處理 multipart 邊界,也不必再依賴第三方上傳外掛。
遇到「只有第一次正確」的 bug,通常要問三件事:這個值是在哪個時刻被求值的?它存在哪裡(閉包、物件屬性、預設參數)?後續變更會不會反映到那個位置?把求值時機攤開來看,問題幾乎都會浮現。AJAX 上傳的參數提交總是因為各種各樣的細節出問題,唯有理解底層機制,才能穩定地避開它們。