$.ajax 的 data 參數看起來簡單,實際上卻藏著幾個容易出錯的細節,本文做個小結。
$.ajax({
type: "POST",
url: "some.php",
// 寫法一:直接給字串
data: "name=John&location=Boston",
// 寫法二:給物件,jQuery 會自動序列化(結果同寫法一)
// data: { name: "John", location: "Boston" },
// 寫法三:陣列值會展開成多組同名參數
// data: { foo: ["bar1", "bar2"] } → &foo=bar1&foo=bar2
success: function (msg) {
alert("Data Saved: " + msg);
}
});
用字串方式傳參時,如果某個值本身含有 & 符號,後端切分參數就會出錯。例如:
// 有問題:name 的值是 john&smith data: "name=john&smith&location=Boston"
後端會把它解析成 name=john、smith=、location=Boston 三個參數,值不完整。這時需要用 encodeURIComponent() 編碼:
data: "name=" + encodeURIComponent("john&smith") + "&location=Boston"
改用物件寫法時,jQuery 會在內部完成編碼,不需要手動處理:
data: { name: "john&smith", location: "Boston" }
反過來要注意的是:如果你用物件寫法卻又自己呼叫 encodeURIComponent,後端收到的會是編碼後的字串(例如 john%26smith),還得多做一次解碼才拿得回原值。兩種方式選一種就好,不要混用。
當 type 為 GET 時,物件形式的 data 會被拼進查詢字串;POST 時則放進 request body。若需要更複雜的結構,可透過 traditional 或 contentType 參數控制序列化方式,例如送出 JSON 時要記得設 contentType: 'application/json'。