萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery $.post dataType 參數詳解:自動 JSON 解析與版本差異

問題現象

$.post('/api/data', {}, function(data) {
  console.log(data.foo);  // undefined ❌
  console.log(data);      // 印出 JSON 字串,非物件
});

原因:未指定 dataType,jQuery 預設智能猜測,低版本可能不自動解析 JSON。

dataType 參數完整說明

dataType行為回傳 data 型別
'json'強制以 JSON 解析Object / Array
'xml'解析為 XML DocumentXMLDocument
'html'純文字,執行腳本String
'script'載入並執行 JSString
'text'純文字不處理String
'jsonp'JSONP 跨域Object
未指定根據 Content-Type 智能猜測不確定

兩種解決方案

方案一:明確指定 'json'(推薦)

$.post('/admin/UserBookView.do', {}, function(data) {
  console.log(data.result.resultList[0].PRICE);  // 3 ✅
}, 'json');  // 第 4 參數指定 dataType

方案二:手動 eval 解析(不推薦,有 XSS 風險)

$.post('/admin/UserBookView.do', {}, function(data) {
  var datas = eval('(' + data + ')');  // ⚠️ 僅信任來源時使用
  console.log(datas.result.resultList[0].PRICE);
});

jQuery 版本差異關鍵點

版本預設行為建議做法
1.4 之前不自動解析 JSON必須指定 'json' 或手動 parseJSON
1.4 - 1.7依賴 Content-Type header建議明確指定 'json'
1.8+嚴格檢查 Content-Type: application/json指定 'json' 更保險
3.0+同上,錯誤處理更完善同左

後端必須設定正確 Header

// Java Spring
response.setContentType("application/json;charset=UTF-8");

// PHP
header('Content-Type: application/json; charset=utf-8');

// C# ASP.NET
Response.ContentType = "application/json; charset=utf-8";

// Node.js Express
res.json(data);  // 自動設定 header

若後端未設定正確 Content-Type,即使指定 dataType:'json' 也可能解析失敗。

完整錯誤處理模板

$.ajax({
  url: '/api/data',
  type: 'POST',
  dataType: 'json',  // 關鍵
  data: { param: 'value' },
  success: function(data, textStatus, jqXHR) {
    // data 已是解析後的物件
    if (data.success) {
      renderData(data.result);
    } else {
      showError(data.message);
    }
  },
  error: function(jqXHR, textStatus, errorThrown) {
    // jqXHR.responseText 可能包含錯誤詳情
    var msg = '請求失敗: ' + textStatus;
    if (jqXHR.responseText) {
      try {
        var err = $.parseJSON(jqXHR.responseText);
        msg += ' - ' + err.message;
      } catch (e) {}
    }
    showError(msg);
  }
});

現代替代:Fetch API

fetch('/api/data', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ param: 'value' })
})
.then(res => {
  if (!res.ok) throw new Error('HTTP ' + res.status);
  return res.json();  // 內建解析
})
.then(data => {
  console.log(data.resultList[0].PRICE);
})
.catch(err => console.error(err));

總結

  • 永遠在 $.post/ajax 中指定 dataType: 'json',不依賴自動偵測
  • 後端務必回傳 Content-Type: application/json
  • 低版本 jQuery (≤1.4) 必須指定,高版本建議指定
  • 避免使用 eval(),安全風險極高
  • 新專案優先使用 fetch 或 axios
copyright © 萬盛學電腦網 all rights reserved