ES5+ 所有瀏覽器內建 `JSON`,**首選原生 API**,無需手寫序列化器。
const obj = { id: 3, name: 'abc', tags: ['a','b'], date: new Date() };
// 序列化
const str = JSON.stringify(obj);
// '{"id":3,"name":"abc","tags":["a","b"],"date":"2024-01-15T08:30:00.000Z"}'
// 反序列化
const parsed = JSON.parse(str);
// 注意:Date 會變為 ISO 字串,需手動轉換
parsed.date = new Date(parsed.date);
// 1. 格式化輸出(調試用)
JSON.stringify(obj, null, 2); // 縮進 2 空格
// 2. 過濾屬性:replacer 為陣列
JSON.stringify(obj, ['id', 'name']); // 只保留 id、name
// 3. 過濾/轉換:replacer 為函數
JSON.stringify(obj, (key, value) => {
if (key === 'password') return undefined; // 排除敏感字段
if (value instanceof Date) return value.toISOString(); // 統一日期格式
return value;
});
// 4. toJSON() 方法:對象自定義序列化行為
const user = {
name: 'Tom',
password: 'secret',
toJSON() {
return { name: this.name }; // 自動排除 password
}
};
JSON.stringify(user); // '{"name":"Tom"}'
原文提供的 `tools.j2s` 展示了手寫序列化的邏輯,現代場景**不建議生產使用**(效能差、邊界情況多、無 `toJSON` 支援),但理解其原理有助於面試與特殊場景(如需序列化 Function/RegExp/Date 為可執行代碼字串)。
function customStringify(obj) {
const type = Object.prototype.toString.call(obj).slice(8, -1); // [object Type] -> Type
switch (type) {
case 'Array':
return '[' + obj.map(customStringify).join(',') + ']';
case 'Object':
return '{' + Object.keys(obj).map(k =>
'"' + k + '":' + customStringify(obj[k])
).join(',') + '}';
case 'String':
return '"' + obj.replace(/["\\]/g, '\\$&') + '"'; // 轉義引號、反斜槓
case 'Number':
case 'Boolean':
return String(obj);
case 'Null':
return 'null';
case 'Date':
return 'new Date(' + obj.getTime() + ')'; // 非標準 JSON,可執行還原
case 'RegExp':
case 'Function':
return obj.toString(); // 非標準 JSON
default:
return 'null';
}
}
原文使用 `eval('(' + str + ')')`,**極度危險**(任意代碼執行)。
// 1. 標準 JSON:JSON.parse(唯一推薦)
const data = JSON.parse(jsonString);
// 2. 若字串包含非標準 JS 字面量(如 new Date()、RegExp、Function)
// 必須用專用解析器,或約定統一格式(如 ISO 日期字串)後手動轉換
function safeParse(str, reviver) {
return JSON.parse(str, (key, value) => {
if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
return new Date(value); // 自動轉日期
}
return reviver ? reviver(key, value) : value;
});
}
// 3. 絕對禁止 eval 的場景
// eval('alert(1)') // XSS 攻擊入口
| 類型 | JSON.stringify | 自定義 j2s | 還原建議 |
|---|---|---|---|
| Date | ISO 字串 | new Date(ms) | reviver 中 new Date() |
| RegExp | {}(空對象) | /pattern/flags | 新專案避免傳輸 RegExp |
| Function | 忽略 | function()... | 不傳輸函數,傳輸函數名/ID |
| undefined | 忽略 | undefined | 轉為 null 或約定字串 |
| Symbol | 忽略 | 忽略 | 轉為字串描述 |
| 循環引用 | 拋錯 | 死遞歸 | 用 flatted / circular-json |
// 使用 flatted (npm i flatted)
import { parse, stringify } from 'flatted';
const a = { name: 'a' };
a.self = a; // 循環引用
const str = stringify(a); // 正常序列化
const obj = parse(str); // 正常反序列化,保持循環結構
JSONStream 流式處理。**生產環境請直接使用 `JSON.stringify` / `JSON.parse`**,配合 `toJSON()`、`replacer`、`reviver` 處理特殊類型。手寫序列化器僅供教學或極特殊需求(如需輸出可執行 JS 代碼)。牢記:**永遠不要用 `eval` 解析不可信字串**。