萬盛學電腦網

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

JS/jQuery 解析 JSON 與數組格式完全指南:從概念到實戰

前後端交互的核心是數據格式協商。JSON、數組、關聯數組(對象)三者關係緊密又易混淆。本文從概念釐清、交互陷阱、解析實戰三個維度,構建完整知識體系,並附贈前後端完整代碼示例。

一、核心概念釐清:三者關係圖譜

1. 數組

  • 語法:[元素1, 元素2, ...],方括號、逗號分隔
  • 特點:有序、索引訪問、長度可變、元素類型任意
  • 示例:var arr = [1, true, 'abc', {x:1}];

2. 關聯數組 / 對象

  • 語法:{key1: val1, key2: val2} 或 {"key1": "val1"}
  • 本質:鍵值對集合,鍵為字符串(ES6 可為 Symbol)
  • 操作:obj.key、obj['key']、for...in 遍歷、delete obj.key

3. JSON (JavaScript Object Notation)

  • 嚴格規範:鍵必須雙引號,字符串值必須雙引號,無尾隨逗號,不支持函數/undefined/註釋
  • 本質:數據交換格式(字符串),非運行時對象
  • 轉換:JSON.parse() → JS 對象/數組,JSON.stringify() → JSON 字符串

關係總結

JSON 字符串  --JSON.parse()-->  JS 對象/數組 (關聯數組/陣列)
JS 對象/數組  --JSON.stringify()--> JSON 字符串

二、前後端交互四大關鍵點

1. 多條記錄傳輸:數組包裹對象

// 服務端返回
[
  {"id":1, "name":"Alice"},
  {"id":2, "name":"Bob"}
]

// 前端接收後直接是數組,可直接 $.each 遍歷

2. 字符串到對象的轉換陷阱

方法適用場景局限性
$.parseJSON(str)標準 JSON 字符串嚴格校驗,單引號/尾逗號/非標準均拋錯
JSON.parse(str)標準 JSON 字符串原生、無依賴、性能更好,推薦首選
eval('('+str+')')非標準 JS 字面量(如單引號、函數)極度危險,XSS 風險,僅信任源可用

3. jQuery AJAX 自動解析機制

$.ajax({
    url: '/api/users',
    dataType: 'json',  // 關鍵:自動調用 JSON.parse
    success: function(users) { // users 已是 JS 數組/對象
        $.each(users, function(i, user) { ... });
    }
});

4. 手動解析的正確姿勢

$.post('/api/data', function(raw) {
    // raw 是字符串
    console.log(typeof raw); // "string"
    
    try {
        const data = JSON.parse(raw); // 推薦
        // const data = $.parseJSON(raw); // 也可
        console.log(data.name); // 正常訪問
    } catch (e) {
        console.error('JSON 解析失敗:', e);
        // 兜底:極少數非標準情況
        // const data = eval('(' + raw + ')'); // 僅絕對信任源
    }
});

三、完整實戰代碼:前後端聯調

前端頁面 (index.html)

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>JSON 解析演示</title>
    <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
</head>
<body>
    <button id="btnJson">請求單個對象 (JSON)</button>
    <button id="btnArray">請求數組集合</button>
    <pre id="output" style="background:#f5f5f5;padding:10px;"></pre>

    <script>
    function log(msg) {
        $('#output').append(msg + '\n');
    }

    // 論單個 JSON 對象
    $('#btnJson').click(function() {
        $.post('/json', function(raw) {
            log('原始類型: ' + typeof raw);
            const obj = JSON.parse(raw); // 推薦原生
            log('解析後類型: ' + typeof obj);
            log('姓名: ' + obj.name);
            log('年齡: ' + obj.age);
            
            // 操作演示
            obj.newField = '動態添加';
            delete obj.sex;
            log('修改後: ' + JSON.stringify(obj));
        });
    });

    // 論求數組
    $('#btnArray').click(function() {
        $.post('/array', function(raw) {
            log('原始類型: ' + typeof raw);
            const arr = JSON.parse(raw);
            log('解析後類型: ' + typeof arr + ', 長度: ' + arr.length);
            $.each(arr, function(i, val) {
                log('索引 ' + i + ': ' + val);
            });
        });
    });
    </script>
</body>
</html>

後端示例 (Java Servlet)

// 返回單個 JSON 對象
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException {
    Map map = new HashMap<>();
    map.put("name", "techbirds");
    map.put("age", 23);
    map.put("sex", "male");
    
    // 使用 JSONObject (需引入 json-lib 或 gson/jackson)
    String json = JSONObject.fromObject(map).toString(); 
    
    resp.setContentType("application/json;charset=UTF-8");
    resp.getWriter().write(json);
}

// 返回 JSON 數組
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException {
    String jsonArray = "[1,2,3,4,5,6]"; // 或 List 轉 JSON
    resp.setContentType("application/json;charset=UTF-8");
    resp.getWriter().write(jsonArray);
}

四、進階技巧與最佳實踐

1. 日期處理

// 序列化時自定義
JSON.stringify(obj, (k, v) => v instanceof Date ? v.toISOString() : v);

// 反序列化時復原
JSON.parse(json, (k, v) => /^\d{4}-\d{2}-\d{2}T/.test(v) ? new Date(v) : v);

2. 大數據流式解析

超大 JSON (超過幾 MB) 避免一次性 parse 阻塞主線程,可用 oboe.js、JSONStream 等流式解析庫。

3. 安全防範

  • 永不 eval 未經驗證的服務端數據
  • 設置 Content-Type: application/json 防 MIME 嗅探
  • 敏感接口加 X-Content-Type-Options: nosniff

五、總結口訣

  1. JSON 是字符串,傳輸時是文本,用時必須 parse
  2. 首選 JSON.parse,原生、快、標準;$.parseJSON 只是薄封裝
  3. 數組套對象 表示列表,$.each(arr, fn) 遍歷無壓力
  4. 後端設置正確 Content-Type,前端 dataType:'json' 可省去手動解析
  5. 非標準格式 寧可改後端輸出標準 JSON,不可用 eval 冒險

搞清這些,前後端對接再也不用為「為什麼報錯 Unexpected token」抓狂。下次見到字符串想當對象用,先 JSON.parse() 再說話。

copyright © 萬盛學電腦網 all rights reserved