| 操作 | 原生標準 API (IE8+) | JSON2.js (舊瀏覽器相容) | jQuery |
|---|---|---|---|
| 物件 → 字串 | JSON.stringify(obj) | JSON.stringify(obj) | 無內建,需外掛 |
| 字串 → 物件 | JSON.parse(str) | JSON.parse(str) | $.parseJSON(str) (3.0 棄用) |
var obj = {
name: "張三",
age: 25,
skills: ["JS", "Vue", "Node"],
address: { city: "台北", zip: "100" },
birth: new Date("1999-01-01"),
active: true,
metadata: undefined, // 會被忽略
secret: function() {} // 會被忽略
};
// 基本用法
var json = JSON.stringify(obj);
// '{"name":"張三","age":25,"skills":["JS","Vue","Node"],"address":{"city":"台北","zip":"100"},"birth":"1999-01-01T00:00:00.000Z","active":true}'
// 參數完整語法:JSON.stringify(value, replacer, space)
// 1. 陣列:只保留指定屬性
JSON.stringify(obj, ["name", "age"]);
// '{"name":"張三","age":25}'
// 2. 函式:自定義轉換邏輯
JSON.stringify(obj, function(key, value) {
if (key === "birth") return value.toISOString().split('T')[0]; // 只取日期
if (key === "secret") return undefined; // 排除
if (typeof value === "string") return value.toUpperCase(); // 大寫
return value;
});
// '{"NAME":"張三","AGE":25,"SKILLS":["JS","VUE","NODE"],"ADDRESS":{"CITY":"台北","ZIP":"100"},"BIRTH":"1999-01-01","ACTIVE":true}'
// 數字:縮排空格數
JSON.stringify(obj, null, 2);
// 輸出含換行縮排的美化字串
// 字串:自定義縮排字元 (如 tab)
JSON.stringify(obj, null, '\t');
var user = {
name: "李四",
password: "secret123", // 敏感欄位不想序列化
token: "abc123",
toJSON: function() {
// 返回要序列化的物件
return {
name: this.name,
// 故意不包含 password, token
loginTime: new Date()
};
}
};
JSON.stringify(user);
// '{"name":"李四","loginTime":"2024-01-15T..."}'
var jsonStr = '{"id":1,"name":"王五","tags":["a","b"],"meta":{"v":1}}';
// 基本解析
var obj = JSON.parse(jsonStr);
console.log(obj.name); // "王五"
// reviver 參數:解析時轉換
var obj2 = JSON.parse(jsonStr, function(key, value) {
if (key === "id") return "ID_" + value; // ID 加前綴
if (key === "tags") return value.join(","); // 陣列轉字串
return value;
});
// { id: "ID_1", name: "王五", tags: "a,b", meta: { v: 1 } }
// 日期字串自動轉 Date 物件
var dateJson = '{"created":"2024-01-15T10:30:00Z"}';
var parsed = JSON.parse(dateJson, function(key, value) {
if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
return new Date(value);
}
return value;
});
console.log(parsed.created instanceof Date); // true
JSON2.js (json2.js) 是 Douglas Crockford 編寫的 Polyfill,為 **IE6/IE7** 提供 JSON 支援。現代專案 (IE8+) **無需引入**,原生 API 已完整支援。
<!-- 條件註解僅 IE8 以下載入 -->
<!--[if lt IE 9]>
<script src="https://cdn.jsdelivr.net/npm/json2@0.1.0/json2.js"></script>
<![endif]-->
<!-- 或 npm 安裝 -->
npm install json2
// import 'json2'; // 在 entry point 最頂部引入
// 等同 JSON.parse(),但會拋出較友善的錯誤訊息
var obj = $.parseJSON('{"a":1}');
// jQuery 3.0+ 棄用,建議直接用 JSON.parse()
<script id="template" type="text/x-jquery-tmpl">
<li>${name} - ${$.formatDate(birth)}</li>
</script>
var data = [
{ name: "A", birth: "2020-01-01" },
{ name: "B", birth: "2020-02-02" }
];
$("#template").tmpl(data).appendTo("#list");
// 注意:jquery.tmpl 官方已停止維護,建議改用現代模板引擎
var a = { name: "A" };
var b = { name: "B", ref: a };
a.ref = b; // 循環引用
JSON.stringify(a);
// TypeError: Converting circular structure to JSON
// 解決方案:
// 方案 A:使用 flatted 庫 (支援循環引用)
import { stringify, parse } from 'flatted';
stringify(a); // 正常輸出
// 方案 B:replacer 過濾 (手動處理)
var seen = new WeakSet();
JSON.stringify(a, function(key, value) {
if (typeof value === "object" && value !== null) {
if (seen.has(value)) return "[Circular]";
seen.add(value);
}
return value;
});
// 方案 C:序列化前移除循環引用
function cleanCircular(obj, seen = new WeakSet()) {
if (typeof obj !== "object" || obj === null) return obj;
if (seen.has(obj)) return undefined;
seen.add(obj);
var cleaned = Array.isArray(obj) ? [] : {};
for (var k in obj) {
if (Object.prototype.hasOwnProperty.call(obj, k)) {
cleaned[k] = cleanCircular(obj[k], seen);
}
}
return cleaned;
}
JSON.stringify(cleanCircular(a));
var json = '{"id": 9007199254740993}'; // 超過 Number.MAX_SAFE_INTEGER (2^53-1)
JSON.parse(json); // { id: 9007199254740992 } 精度丟失!
// 解決:使用 JSON.parse 配合 reviver,或使用 json-bigint
// npm install json-bigint
const JSONbig = require('json-bigint');
JSONbig.parse(json); // { id: 9007199254740993n } (BigInt)
// ISO 8601 標準格式 (推薦)
new Date().toISOString(); // "2024-01-15T10:30:00.000Z"
// 解析時統一處理
function parseWithDates(json) {
return JSON.parse(json, (key, value) => {
if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) {
return new Date(value);
}
return value;
});
}
| 場景 | 建議 |
|---|---|
| 大量資料序列化 | 分批處理、Web Worker、避免同步阻塞主執行緒 |
| 頻繁序列化同結構物件 | 使用 JSON.stringify 內建優化,或預編譯 schema (如 fast-json-stringify) |
| 傳輸大量資料 | 考慮 Protocol Buffers、MessagePack、CBOR 等二進制格式 |
| 本地儲存 | localStorage 存 JSON 字串,讀取時 parse,注意 5MB 限制 |
eval("(" + jsonStr + ")") 極度危險,會執行任意代碼。JSON.parse() 或 $.parseJSON()。
function safeParse(jsonStr, defaultValue = null) {
try {
return JSON.parse(jsonStr);
} catch (e) {
console.warn("JSON 解析失敗:", e.message, "輸入:", jsonStr.substring(0, 100));
return defaultValue;
}
}
// 使用
var config = safeParse(localStorage.getItem("config"), { theme: "light" });
現代 JavaScript 開發**直接使用原生 JSON.stringify() 和 JSON.parse()**,支援 IE8+ 所有瀏覽器。JSON2.js 僅供 IE6/7 相容專案使用。掌握 replacer、reviver、space、toJSON() 進階參數,能靈活處理日期、循環引用、敏感欄位過濾、美化輸出等實務需求。避免 eval(),做好錯誤處理,大數字場景考慮 json-bigint。