用 jQuery 的 ajax 系列方法時,經常遇到「代碼順序看著對,執行順序卻不對」的困擾。這背後是異步機制,而 async 參數就是控制它的開關。
function existProduct(obj) {
var productname = escape(obj.val());
$.getJSON("../product/searchProductByName.action", data, function (data) {
var falg;
falg = data[0]['existproduct']; // falg 返回 no 或 yes
return falg;
});
}
function validateform() {
if (validateNotnull($("#products_name"))) {
if (existProduct($("#products_name"))) {
$("#productform").submit();
} else {
$("#spanproduct").html("業務名稱已經存在");
}
} else {
$("#spanproduct").html("業務名稱不能為空");
}
}
用 firebug 檢查,請求確實發出、響應也正確,但執行時 return falg 先跑了,getJSON 反而在後面執行——順序完全顛倒。
$.getJSON 是異步的。調用它時,jQuery 只是把請求登記進去就立刻返回,腳本繼續往下執行。網絡請求在後台進行,等響應到達後,才由瀏覽器把參數塞進回調函數執行。
所以真實順序是:existProduct 發起請求後立即返回 undefined → validateform 拿到 undefined 走 else → 很久之後回調才被調用。而回調裡的 return 只是結束回調函數自身,返回值無人接收。
關鍵認識:異步函數的返回值不可能包含異步操作的結果。這不是 jQuery 的 bug,是 JavaScript 執行模型的必然。
把 async 設為 false,jQuery 會改用同步 XHR,阻塞當前線程直到響應到達,這樣返回值就正常了:
function existProduct(name) {
var result;
$.ajax({
url: "../product/searchProductByName.action",
type: "GET",
data: { name: name },
dataType: "json",
async: false, // 同步請求
success: function (data) {
result = data[0]['existproduct'];
}
});
return result; // 此時 result 已經有值
}
為什麼不建議這樣做:
同步 XHR 只在極罕見場景下有正當用途,比如 beforeunload 裡發送統計數據,而這些場景今天更推薦用 navigator.sendBeacon()。
function validateform() {
if (!validateNotnull($("#products_name"))) {
$("#spanproduct").html("業務名稱不能為空");
return;
}
$.getJSON("../product/searchProductByName.action",
{ name: $("#products_name").val() },
function (data) {
if (data[0]['existproduct'] == 'yes') {
$("#productform").submit();
} else {
$("#spanproduct").html("業務名稱已經存在");
}
}
);
}
思路轉變在於:不再試圖「先拿到結果再處理」,而是「註冊拿到結果之後要做什麼」。
function checkProduct(name) {
return $.getJSON("../product/searchProductByName.action", { name: name });
}
function validateform() {
if (!validateNotnull($("#products_name"))) {
$("#spanproduct").html("業務名稱不能為空");
return;
}
checkProduct($("#products_name").val())
.then(function (data) {
if (data[0]['existproduct'] == 'yes') {
$("#productform").submit();
} else {
$("#spanproduct").html("業務名稱已經存在");
}
})
.fail(function () {
$("#spanproduct").html("校驗失敗,請重試");
});
}
jQuery 1.5 起,所有 ajax 方法返回的都是 thenable 對象,可以鏈式處理。多個異步步驟串聯時,Promise 比嵌套回調可讀性高得多。
async function validateform() {
if (!validateNotnull($("#products_name"))) {
$("#spanproduct").html("業務名稱不能為空");
return;
}
try {
var data = await $.getJSON("../product/searchProductByName.action",
{ name: $("#products_name").val() });
if (data[0]['existproduct'] == 'yes') {
$("#productform").submit();
} else {
$("#spanproduct").html("業務名稱已經存在");
}
} catch (e) {
$("#spanproduct").html("校驗失敗,請重試");
}
}
注意函數上的 async 關鍵字。這種寫法在視覺上最接近同步代碼,異步步驟之間的關係一目了然,是今天的首選。
变量名 falg 是 flag 的拼寫錯誤;escape() 已廢棄,編碼 URL 參數應使用 encodeURIComponent();existProduct 裡聲明了 productname 卻從未使用,屬多餘代碼;內外兩層回調都用 data 作參數名,雖然因作用域規則不會出錯,但容易誤導閱讀者。