DIV CSS 佈局教程網

jQuery Ajax 常用選項梳理:從 dataType 到錯誤回呼
編輯:JQuery入門技巧     

Ajax 是後端與前端溝通的主要管道,而 jQuery 的 $.ajax() 把麻煩的 XMLHttpRequest 差異都處理掉了,我們只要把選項填對即可。本文整理最常用到的幾個參數。

先談談 JSON

JSON(JavaScript Object Notation)是一種輕量級的資料交換格式,特性是與平台無關、可讀性高,因此在 Ajax 溝通中幾乎是標準配備。

常見的兩種轉換:

1. Java 物件轉 JSON 字串:後端可用 Jackson 的 ObjectMapper,呼叫 writeValueAsString(物件)。

2. JSON 字串轉 JavaScript 物件:用 JS 內建的 JSON.parse()。若回傳的是物件組成的陣列字串,同樣用 parse 處理即可。

補充一個實務重點:早期程式碼常看到 eval("("+data+")") 這種寫法,它會執行字串中的任意程式碼,存在 XSS 風險,請一律改用 JSON.parse()。

$.ajax() 的常用選項

$.ajax({
  url: "請求位址(相對路徑或完整 URL)",
  type: "請求方法,get / post",
  data: {
    // 可以是物件形式,jQuery 會自動序列化成查詢字串
    "adminCode": "king",
    "age": 22
  },
  // 也可以是字串形式:"adminCode=king&age=22"
  dataType: "伺服器預期回傳的資料型別",
  //   "json"   → 自動轉為 JavaScript 物件
  //   "text"   → 純文字字串
  //   "html"   → HTML 片段
  //   "xml"    → XML 文件
  //   "script" → 直接執行 JavaScript
  success: function(response){
    // 請求成功時的處理,response 已依 dataType 轉好
  },
  error: function(xhr, status, error){
    // 請求失敗(4xx / 5xx、逾時、斷網等)
  }
});

幾個容易忽略的細節

dataType 是「告訴 jQuery 回傳什麼」。如果伺服器明明回 JSON 卻沒設 dataType,jQuery 會依 Content-Type 猜測,猜錯時 success 收到的會是字串,此時 JSON.parse 之前要先確認型別。

type 預設是 GET。要送出敏感資料或大量內容時請用 POST,並注意 GET 的參數會出現在網址上、留下瀏覽紀錄。

別忘了 timeout。不設逾時的請求可能永遠掛著,載入畫面一直轉。實務上建議加上 timeout 並在 error 中給使用者友善提示。

其餘值得知道的選項:

async(是否非同步,預設 true,設 false 會凍結整個頁面,強烈不建議)、beforeSend(可在送出前修改 request header)、cache(GET 請求的快取控制)、context(回呼中的 this 指向)、traditional(參數序列化方式)。

如果只是一次簡單請求,也可以直接用語意更清楚的簡寫:$.getJSON()、$.getScript()、$.post(),本質上都是 $.ajax 的包裝。

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