有一個全域變數 var JsonData;,以及一個 AJAX 處理方法,想在另一個函式中使用取回的資料,卻總是拿到空的。這是非同步程式設計最典型的困惑。
var JsonData;
function GetJson(DataSourceName) {
$.ajax({
type: "post",
url: "Ajax/AjaxData.ashx?MethodName=" + DataSourceName,
contentType: "application/json;",
data: "",
dataType: "json",
success: function (Result) {
JsonData = Result;
},
error: function (result) {
alert("獲取信息列表錯誤");
window.close();
}
});
return JsonData;
}
function DrawDropDownList(sFieldRuleMethod) {
GetJson(sFieldSourceName);
var b = JsonData; // 這裡永遠是 undefined
}
打斷點追蹤會發現一個反直覺的現象:DrawDropDownList 裡的所有程式都執行完了,才轮到 GetJson 的 success 回呼被呼叫。
原因在於 $.ajax 預設是非同步的。它的執行順序是:
一、DrawDropDownList 呼叫 GetJson。
二、GetJson 送出請求,把請求交給瀏覽器的網路層,立刻回傳(此時 return JsonData 執行,值還是 undefined)。
三>控制權回到 DrawDropDownList,執行 var b = JsonData;,依然是 undefined。
四>……一段時間後回應抵達,瀏覽器呼叫 success 回呼,這時才對 JsonData 赋值。但外層早就跑完了。
所以問題不是「資料沒回來」,而是「你取值的那一刻,資料還在路上」。
把 async 設為 false,讓請求變成阻塞式,return JsonData 就會等到資料回來後才執行:
function GetJson(DataSourceName) {
$.ajax({
type: "post",
url: "Ajax/AjaxData.ashx?MethodName=" + DataSourceName,
contentType: "application/json",
data: "",
dataType: "json",
async: false,
success: function (Result) { JsonData = Result; }
});
return JsonData; // 現在能取到值
}
但這個做法不建議使用。同步請求會凍結整個瀏覽器 UI,直到回應抵達為止;網路稍慢,使用者會以為網頁當機。jQuery 官方也已將 async: false 標記為不宜使用的選項,若真的需要,替代方案是放在 Web Worker 中執行。
既然資料只能在回呼中取得,就把「拿到資料之後要做什麼」也交給回呼,而不是試圖用 return 把資料取出來:
function GetJson(DataSourceName, callback) {
$.ajax({
type: "post",
url: "Ajax/AjaxData.ashx?MethodName=" + DataSourceName,
contentType: "application/json",
data: "",
dataType: "json",
success: function (Result) {
JsonData = Result;
callback(JsonData); // 把結果交給呼叫端
},
error: function (result) {
alert("獲取信息列表錯誤");
}
});
}
function DrawDropDownList(sFieldSourceName) {
GetJson(sFieldSourceName, function (data) {
// 在這裡使用資料,此時它一定已經就緒
var b = data;
// 繫結下拉選單...
});
}
這樣 GetJson 仍然是一個通用的資料取得方法,不必在裡面寫特定頁面的邏輯,而呼叫端也能正確拿到資料。
更現代的寫法是回傳 Promise,讓呼叫端用 then 串接。jQuery 的 $.ajax 本身就回傳 Promise-like 物件,因此不必額外包裝:
function GetJson(DataSourceName) {
return $.ajax({
type: "post",
url: "Ajax/AjaxData.ashx?MethodName=" + DataSourceName,
contentType: "application/json",
data: "",
dataType: "json"
});
}
GetJson(sFieldSourceName).then(function (data) {
// 使用資料
}).catch(function () {
alert("獲取信息列表錯誤");
});
用原生 fetch 也是同樣的思路:
async function GetJson(name) {
var res = await fetch('Ajax/AjaxData.ashx?MethodName=' + encodeURIComponent(name));
if (!res.ok) { throw new Error('請求失敗'); }
return res.json();
}
// 呼叫端
GetJson('xxx').then(function (data) {
console.log(data);
});
原程式中的 contentType: "application/json;" 末尾多了一個分號,MIME 類型應該是 application/json,多餘的分號會讓部分後端框架解析失敗。另外,把參數直接串在網址上(?MethodName=" + DataSourceName)若值含有特殊字元會出問題,建議改用 data 物件並讓 jQuery 編碼。
這類問題的根源只有一句話:非同步函式在回傳時,結果通常還沒準備好。因此有三種正確應對:接受回呼、回傳 Promise、或使用 async/await。至于用全域變數加同步請求硬取,雖然能讓程式「動起來」,卻是把問題藏起來而非解決它——一旦同一頁有多個請求並行,全域變數就會互相覆蓋,衍生更難查的 bug。