DIV CSS 佈局教程網

jQuery $.ajax() 接收 JSON 資料的完整用法與參數解析
編輯:JQuery特效代碼     

用 jQuery 跟後端交換 JSON 是很日常的工作,但要收到資料基本上就兩個條件:後端得輸出合法 JSON,前端的 dataType 也要對得上。這篇把常見寫法與 $.ajax() 的參數一次講清楚。

跨網域時用 jsonp

如果資料來源不在同一個網域,瀏覽器的同源政策會擋下來,這時改用 dataType: "jsonp",jQuery 會自動動態插入 <script> 標籤並附上一個 callback 參數,後端只要把 JSON 包進那個 callback 函式呼叫裡即可。

. 代碼如下:

$('#send').click(function () {
  $.ajax({
    type : "GET",
    url : "a.php",
    dataType : "jsonp",
    success : function (data) {
      $.each(data.items, function (i, item) {
        $("<img class='para'/>").attr("src", item.media.m).appendTo("#resText");
        if (i == 3) { return false; }  // 只要前四筆
      });
    }
  });
});

這裡有個容易忽略的細節:$.each() 的回呼若 return false,等於 break,會中止整個迴圈;這正好拿來限制筆數。

同網域時用 json

. 代碼如下:

$.ajax({
  type: "POST",
  url: ctxRoot + '/FolderAction!saveInformSetting.action',
  data: { jsonStr: inform_settingListStr },
  dataType: "json",
  complete: function(data){
    // 有時可以直接 data.name 取值,
    // 但有時必須先 eval("("+data.responseText+")") 才拿得到,
    // 而且這種情況只能用 complete,不能用 success
  }
});

為什麼會有「只能用 complete」的這種情況?因為 complete 拿到的是原始的 jqXHR 物件,你得自己解析 responseText;而 success 拿到的是 jQuery 已依 dataType 解析好的物件。兩者層級不同,混用就會出現「明明有回應卻取不到值」的錯覺。

另外要提醒:用 eval() 解析後端字串是危險行為,若內容可能被使用者影響就成了 XSS 入口。請改用 JSON.parse() 或 jQuery 的 $.parseJSON()。

$.ajax() 參數速查

url(string)請求位址,可以是頁面也可以是 WebService 動作。

type(string)請求方法,GET 或 POST。查詢用 GET,會改動資料用 POST。

data(object / string)要送出的資料。物件形式如 {name:"grayworm", sex:"male"},jQuery 會自動序列化;陣列形式如 {works:["work1","work2"]} 會被展開成 works[]=work1&works[]=work2。

dataType(string)預期回應的型別:xml、html、json、jsonp、text。指定得越準,jQuery 就不用猜,也能少一層轉換。

beforeSend(Function)送出前觸發,回傳 false 可取消這次請求。要顯示 loading 動畫就寫在這裡。

success / error / complete 分別是成功、失敗、以及不論結果都會執行的收尾。關閉 loading 動畫請放 complete,寫在 success 裡的話一旦請求失敗轉盤就會永遠轉下去。

timeout(number)逾時毫秒數。不設定的話在網路異常時可能等很久,建議一定要設。

現在會怎麼寫

如果今天重寫,我會改用 $.getJSON()/$.post() 這類語意清楚的捷徑,或直接改用 fetch() 搭配 async/await。同時別忘了:dataType: "json" 時若回應不是合法 JSON,success 不會觸發而是走 error,這個行為常讓人誤判成「後端沒回應」,記得先看 DevTools 的 Network 面板確認實際內容。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved