DIV CSS 佈局教程網

jQuery Ajax 的返回值處理與無返回值情境
編輯:JavaScript綜合知識     

jQuery 的 Ajax 可以回傳 html、text、json、xml 等多種格式,而「怎麼把資料取出來」以及「不需要資料時怎麼寫」,是兩個都容易出錯的地方。

$.post:用匿名函式接收

$.post("test.jsp",
    { name: "cssrain", time: "2008/01/21" },   // 要傳遞的數據
    function (data) {
        alert("返回的數據: " + data);
    }
);

回傳值就是回呼函式的第一個參數 data,在該函式內處理即可。

$.load:把結果直接塞進元素

$("#loadajax").load("test.jsp .post", function (responseText, textStatus, XMLHttpRequest) {
    // 此處的 this 指向目前的 DOM 物件
});
<div id="loadajax"></div>

$.load() 除了提供回呼,本身就會把回應內容寫入選到的元素,是三者中最省事的一個。

$.ajax:以 json 格式取回並綁定

$.ajax({
    type: "get",
    dataType: "json",          // 回傳 json 格式的數據
    url: "BackHandler.ashx",
    data: "pageIndex=" + pageIndex,
    complete: function () { $("#load").hide(); },   // 請求完成時隱藏 loading
    success: function (msg) {
        var data = msg.table;
        $.each(data, function (i, n) {
            var row = $("#template").clone();
            row.find("#OrderID").text(n.訂單ID);
            row.find("#CustomerID").text(n.客戶ID);
            row.find("#OrderDate").text(ChangeDate(n.訂購日期));
            row.attr("id", "ready");           // 改 id,避免與樣板衝突
            row.appendTo("#datas");
        });
    }
});

無返回值時的陷阱

Ajax 的回呼分 success 與 error 兩種情況。有時我們只是要「送出資料」,並不需要伺服器回傳什麼,卻仍照範本寫了 dataType: "json"——這時即使伺服器回傳 200 成功狀態,也會報錯。

原因是 jQuery 拿到空回應後,仍試圖用 JSON 解析器去解析,解析失敗便判定為錯誤並走進 error 分支。沒有回傳資料時,就不要設定 dataType。正確範本如下:

$.ajax({
    type: "post",
    url: "index.php",
    data: "id=" + uid,
    success: function () { alert(1); },
    error:   function () { alert(0); }
});

一個真實案例:非同步取值拿不到結果

曾經寫過一個即時檢查信箱是否已被註冊的函式,卻總是拿到 undefined:

$.get("register.php", { check_name: "email", check_value: email_value }, function (json) {
    if (json == "ok") {
        $('#res_mail').html("此 email 可以註冊");
        return true;        // ← 這個 return 幫不到外層函式
    } else {
        $('#res_mail').html("此 email 已被註冊");
        return false;
    }
});

問題的核心是:$.get 預設是非同步的。在請求還沒完成時,外層函式就已經執行到 return 了,此時變數仍是初始值,所以永遠拿到 false。而且回呼函式內的 return 只是回傳給 Ajax 內部,對外層函式毫無影響。

解法有兩個。一是把請求改成同步(async: false),讓執行順序回到可預期:

$.get("register.php",
    { check_name: "email", check_value: email_value, async: false },
    function (json) { /* ... */ }
);

二是改用 $.data() 保存狀態,事後再取出:

var boolean = false;
$.get(url, null, function (data) {
    if (data.indexOf("true") >= 0) {
        $("#mid").html("登陸成功");
        boolean = true;
        $.data("bl", boolean);
    } else {
        $("#mid").html("用戶名或密碼錯誤");
        boolean = false;
        $.data("bl", boolean);
    }
});

不過老實說,async: false 會凍結整個 UI 執行緒,現代瀏覽器也已在主執行緒上全面禁用同步 XHR。真正該採用的做法是把後續邏輯寫進回呼裡,而不是試圖從非同步函式「回傳」結果:

function checkEmail(email, callback) {
    $.get("register.php", { check_name: "email", check_value: email }, function (json) {
        callback(json === "ok");
    });
}

// 使用
checkEmail(value, function (available) {
    if (available) { /* 處理可註冊的情況 */ }
});
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved