核心概念
AJAX 原生只能傳輸**字串**。傳遞陣列、物件等結構化資料,需經過 **JSON (JavaScript Object Notation)** 序列化/反序列化。
後端編碼 (PHP 範例)
<?php
// 模擬課程狀態資料
$lessons = [
'8yuwen' => true, // 八年級語文:上課中
'9yuwen' => false, // 九年級語文:未上課
'8wuli' => true, // 八年級物理:上課中
'9wuli' => false // 九年級物理:未上課
];
header('Content-Type: application/json; charset=utf-8');
echo json_encode($lessons); // {"8yuwen":true,"9yuwen":false,"8wuli":true,"9wuli":false}
?>
前端解析 (jQuery)
$.ajax({
url: '/api/lesson-status',
type: 'GET',
dataType: 'json', // ★ 關鍵:自動解析 JSON → JavaScript 物件
success: function(data) {
// data 已是物件,直接存取屬性
updateLessonUI('8yuwen', data['8yuwen']);
updateLessonUI('9yuwen', data['9yuwen']);
updateLessonUI('8wuli', data['8wuli']);
updateLessonUI('9wuli', data['9wuli']);
},
error: function(xhr, status, err) {
console.error('AJAX 失敗:', status, err);
}
});
function updateLessonUI(id, isActive) {
$('#' + id).css('color', isActive ? 'red' : '');
// 或切換 class: $('#'+id).toggleClass('active', isActive);
}
原生 JavaScript (Fetch API)
fetch('/api/lesson-status')
.then(res => {
if (!res.ok) throw new Error('HTTP ' + res.status);
return res.json(); // 解析 JSON
})
.then(data => {
Object.keys(data).forEach(id => updateLessonUI(id, data[id]));
})
.catch(err => console.error(err));
舊版寫法與風險 (不可取)
// ❌ 危險:eval 執行任意代碼,XSS 風險極高
var data = eval('(' + responseText + ')');
// ❌ 手工拼接字串,易出錯、難維護
var arr = responseText.split(',');
var obj = {};
arr.forEach(function(item) { ... });
JSON 完整資料類型對應表
| JSON 類型 | JavaScript 類型 | PHP 類型 | Java 類型 | Python 類型 |
| Object | Object | 關聯陣列 / stdClass | Map / POJO | dict |
| Array | Array | 索引陣列 | List / Array | list |
| String | String | String | String | str |
| Number | Number | int/float | int/long/double | int/float |
| true/false | Boolean | bool | boolean | bool |
| null | null | null | null | None |
進階:處理大型資料 / 流式解析
- JSON.parse() 需將完整字串載入記憶體
- 超大資料集 → 考慮 **NDJSON** (Newline Delimited JSON) 分行傳輸,逐行解析
- 或使用 **Oboe.js** / **JSONStream** 串流解析
安全性檢查清單
- ✅ 後端設定 `Content-Type: application/json`
- ✅ 前端指定 `dataType: 'json'` 或 `res.json()`
- ✅ **絕不使用 `eval()`** 解析不可信來源
- ✅ 輸出前驗證資料結構 (JSON Schema / 類型檢查)
- ✅ 敏感資料不應透過 AJAX 直接回傳前端
常見錯誤排查
| 現象 | 原因 | 解決 |
| SyntaxError: Unexpected token | 回傳非合法 JSON (如 HTML 錯誤頁、BOM、前綴字元) | 檢查回應原始內容、確保無輸出雜訊 |
| data 為 undefined | 未設定 `dataType: 'json'`、或回應非 JSON | 加上 dataType、檢查後端 header |
| 中文亂碼 | 編碼不一致 | 統一 UTF-8:資料庫、PHP 檔案、HTTP header、HTML meta |
| 大數字精度丟失 | JS Number 為 IEEE 754,> 2^53 失去精度 | 後端以字串傳遞大整數 (ID、金額分)、前端用 BigInt |
copyright ©
萬盛學電腦網 all rights reserved