JSON (JavaScript Object Notation) 是輕量級資料交換格式,易讀易寫、易於機器解析生成。基於 JavaScript 物件字面語法子集,但**獨立於語言**,現為 Web API 事實標準。
| 類型 | 表示法 | 範例 | 注意 |
|---|---|---|---|
| 物件 | { "key": value, ... } | {"name":"John", "age":30} | 鍵**必須雙引號**、無尾隨逗號 |
| 陣列 | [value, ...] | [1, "two", true, null, {}, []] | 值可混合類型 |
| 字串 | "text" | "Hello\nWorld" | **雙引號**、支援跳脫字元 |
| 數值 | 整數/浮點數 | 42, 3.14, -10, 1e5 | 無 NaN/Infinity、無前導零 |
| 布林 | true/false | true | 小寫 |
| 空值 | null | null | 小寫 |
{
"user": {
"id": 123,
"name": "張三",
"roles": ["admin", "editor"],
"profile": {
"email": "zhang@example.com",
"active": true
}
},
"meta": {
"timestamp": 1702987200000,
"version": "1.0"
}
}
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
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"}'
// 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/函數/Symbol | JSON.stringify 忽略/轉 null | 預期行為,若需保留需自訂 replacer |
| 循環參考 | TypeError: Converting circular structure to JSON | 用 flatted 庫、或 replacer 過濾、或手動斷開循環 |
| 大數值精度遺失 | JSON.parse('9007199254740993') → 9007199254740992 | JS Number 為 IEEE 754,用字串傳輸大整數、或用 BigInt (JSON 不支援) |
| 日期物件序列化 | 變成 ISO 字串 "2024-01-15T10:30:00.000Z" | 預期行為,解析端用 reviver 還原 |
絕對不要 用 eval('(' + jsonStr + ')') 解析 JSON!
JSON.parse()// 定義 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); // 失敗時的詳細錯誤
JSONStream (Node.js) / oboe.js (瀏覽器):邊下載邊解析,不佔用大量記憶體。JSON.parse() (字串→物件)、JSON.stringify() (物件→字串)。dataType: 'json' 自動處理解析,發送時手動 JSON.stringify() + contentType。