萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

JavaScript 處理 AJAX 回傳陣列/物件:JSON 解析完整指南

核心概念

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 類型
ObjectObject關聯陣列 / stdClassMap / POJOdict
ArrayArray索引陣列List / Arraylist
StringStringStringStringstr
NumberNumberint/floatint/long/doubleint/float
true/falseBooleanboolbooleanbool
nullnullnullnullNone

進階:處理大型資料 / 流式解析

  • JSON.parse() 需將完整字串載入記憶體
  • 超大資料集 → 考慮 **NDJSON** (Newline Delimited JSON) 分行傳輸,逐行解析
  • 或使用 **Oboe.js** / **JSONStream** 串流解析

安全性檢查清單

  • ✅ 後端設定 `Content-Type: application/json`
  • ✅ 前端指定 `dataType: 'json'` 或 `res.json()`
  • ✅ **絕不使用 `eval()`** 解析不可信來源
  • ✅ 輸出前驗證資料結構 (JSON Schema / 類型檢查)
  • ✅ 敏感資料不應透過 AJAX 直接回傳前端

常見錯誤排查

copyright © 萬盛學電腦網 all rights reserved
現象原因解決
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