萬盛學電腦網

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

深入理解 JSON 資料格式:語法規範、JavaScript 原生處理、jQuery AJAX 整合、常見陷阱

什麼是 JSON?

JSON (JavaScript Object Notation) 是輕量級資料交換格式,易讀易寫、易於機器解析生成。基於 JavaScript 物件字面語法子集,但**獨立於語言**,現為 Web API 事實標準。

JSON 語法規範 (RFC 8259)

類型表示法範例注意
物件{ "key": value, ... }{"name":"John", "age":30}鍵**必須雙引號**、無尾隨逗號
陣列[value, ...][1, "two", true, null, {}, []]值可混合類型
字串"text""Hello\nWorld"**雙引號**、支援跳脫字元
數值整數/浮點數42, 3.14, -10, 1e5無 NaN/Infinity、無前導零
布林true/falsetrue小寫
空值nullnull小寫

合法 JSON 範例

{
    "user": {
        "id": 123,
        "name": "張三",
        "roles": ["admin", "editor"],
        "profile": {
            "email": "zhang@example.com",
            "active": true
        }
    },
    "meta": {
        "timestamp": 1702987200000,
        "version": "1.0"
    }
}

JavaScript 原生處理

解析:JSON.parse()

var jsonStr = '{"name":"John", "age":30}';
var obj = JSON.parse(jsonStr);
console.log(obj.name); // "John"

// 進階:reviver 函數轉換日期字串為 Date 物件
var jsonWithDate = '{"date":"2024-01-15T10:30:00Z"}';
var obj2 = JSON.parse(jsonWithDate, function(key, value) {
    if (key === 'date' && typeof value === 'string') {
        return new Date(value);
    }
    return value;
});
console.log(obj2.date instanceof Date); // true

序列化:JSON.stringify()

var obj = { name: 'John', age: 30, skills: ['JS', 'CSS'] };
var json = JSON.stringify(obj); 
// '{"name":"John","age":30,"skills":["JS","CSS"]}'

// 格式化輸出 (縮排 2 空格)
var pretty = JSON.stringify(obj, null, 2);

// 過濾/轉換:replacer 函數
var filtered = JSON.stringify(obj, function(key, value) {
    if (key === 'age') return undefined; // 排除 age
    return value;
}); // '{"name":"John","skills":["JS","CSS"]}'

// 自訂 toJSON() 方法
var user = {
    name: 'John',
    password: 'secret', // 敏感欄位
    toJSON: function() {
        return { name: this.name }; // 序列化時只輸出 name
    }
};
console.log(JSON.stringify(user)); // '{"name":"John"}'

jQuery 與 JSON 整合

// 1. 發送 JSON 請求
$.ajax({
    url: '/api/users',
    method: 'POST',
    contentType: 'application/json', // 告訴伺服器發送 JSON
    data: JSON.stringify({ name: 'John', age: 30 }), // 物件轉字串
    dataType: 'json', // 預期回應為 JSON,自動 parse
    success: function(response) {
        // response 已是物件
        console.log(response.id);
    }
});

// 2. 便捷方法:$.getJSON (僅 GET)
$.getJSON('/api/users/123', function(user) {
    console.log(user.name);
});

// 3. $.post 發送表單資料 (預設 application/x-www-form-urlencoded)
// 若要發送 JSON,需用 $.ajax 設定 contentType

常見陷阱與解決

陷阱現象解決
單引號字串{'name':'John'} JSON.parse 失敗嚴格雙引號,或用 JS 物件字面量 (非 JSON)
尾隨逗號{"a":1,} 解析錯誤移除最後逗號
註解{/*comment*/"a":1} 非標準 JSON移除註解,或用 JSON5/JSONC (需解析器支援)
undefined/函數/SymbolJSON.stringify 忽略/轉 null預期行為,若需保留需自訂 replacer
循環參考TypeError: Converting circular structure to JSON用 flatted 庫、或 replacer 過濾、或手動斷開循環
大數值精度遺失JSON.parse('9007199254740993') → 9007199254740992JS Number 為 IEEE 754,用字串傳輸大整數、或用 BigInt (JSON 不支援)
日期物件序列化變成 ISO 字串 "2024-01-15T10:30:00.000Z"預期行為,解析端用 reviver 還原

安全性:避免 eval() 解析 JSON

絕對不要 用 eval('(' + jsonStr + ')') 解析 JSON!

  • 安全風險:執行任意代碼 (XSS)
  • 效能差:啟動編譯器
  • 標準:永遠用 JSON.parse()

進階主題

JSON Schema 驗證

// 定義 Schema
const schema = {
    type: 'object',
    properties: {
        name: { type: 'string', minLength: 1 },
        age: { type: 'integer', minimum: 0, maximum: 150 }
    },
    required: ['name'],
    additionalProperties: false
};

// 使用 ajv 驗證
const Ajv = require('ajv');
const ajv = new Ajv();
const validate = ajv.compile(schema);
const valid = validate({ name: 'John', age: 30 }); // true
console.log(validate.errors); // 失敗時的詳細錯誤

Streaming JSON 處理大量資料

  • JSONStream (Node.js) / oboe.js (瀏覽器):邊下載邊解析,不佔用大量記憶體。
  • NDJSON (Newline Delimited JSON):每行一個 JSON 物件,適合日誌、串流。

總結

  • JSON 是**字串格式**,非 JS 物件。傳輸/儲存時是字串,記憶體中是物件。
  • 核心 API:JSON.parse() (字串→物件)、JSON.stringify() (物件→字串)。
  • 嚴格遵守雙引號、無尾隨逗號、無註解、無 undefined/函數。
  • jQuery dataType: 'json' 自動處理解析,發送時手動 JSON.stringify() + contentType。
  • 大型/高效能/串流場景考慮 NDJSON、JSONStream、Schema 驗證。
copyright © 萬盛學電腦網 all rights reserved