JSON (JavaScript Object Notation) 是輕量級資料交換格式,易於人閱讀、機器解析。現代 Web 開發中,前後端資料傳輸、設定檔、API 回應幾乎都使用 JSON。
// 定義物件
var finalInfo = {
purchaseInfoId: "",
purchaseMethodType: "",
contact: "",
contactTel: "",
bidInfoStr: ""
};
// 序列化為 JSON 字串
var finalInfoStr = JSON.stringify(finalInfo);
// 結果:'{"purchaseInfoId":"","purchaseMethodType":"","contact":"","contactTel":"","bidInfoStr":""}'
var data = {};
data.id = 123;
data.name = "產品名稱";
data.tags = ["熱銷", "推薦"];
data.price = 999;
data.inStock = true;
var jsonStr = JSON.stringify(data);
$.fn.toJSON = function() {
var obj = {};
$.each(this.serializeArray(), function(i, field) {
if (obj[field.name] !== undefined) {
if (!Array.isArray(obj[field.name])) obj[field.name] = [obj[field.name]];
obj[field.name].push(field.value);
} else {
obj[field.name] = field.value;
}
});
return JSON.stringify(obj);
};
// 使用
var json = $("#myForm").toJSON();
var obj = { a: 1, b: { c: 2 } };
JSON.stringify(obj, null, 2); // 第三參數:縮排空格數
// 結果:
// {
// "a": 1,
// "b": {
// "c": 2
// }
// }
var obj = {
name: "測試",
password: "secret", // 敏感欄位不想輸出
createdAt: new Date(),
circular: null
};
obj.circular = obj; // 循環引用
var json = JSON.stringify(obj, function(key, value) {
if (key === "password") return undefined; // 排除欄位
if (value instanceof Date) return value.toISOString(); // 日期格式化
if (typeof value === "object" && value !== null) {
// 簡單循環引用檢測
if (this[key] === value) return "[Circular]";
}
return value;
}, 2);
var User = function(name, email) {
this.name = name;
this.email = email;
this._internal = "secret";
};
User.prototype.toJSON = function() {
// 只序列化公開屬性
return {
name: this.name,
email: this.email
};
};
var user = new User("王小明", "wang@example.com");
JSON.stringify(user); // '{"name":"王小明","email":"wang@example.com"}'
預設 JSON.stringify 將 Date 轉為 ISO 8601 字串("2024-01-15T08:30:00.000Z"),UTC 時間。若需本地時間或特定格式:
// 方案 1:序列化前手動轉換
obj.createdAt = obj.createdAt.toISOString(); // 或自訂格式
// 方案 2:使用 replacer 統一處理
var json = JSON.stringify(obj, (k, v) => v instanceof Date ? v.toISOString() : v);
// 方案 3:使用成熟庫(如 date-fns, dayjs)格式化後再序列化
var jsonStr = '{"id":1,"name":"張三","tags":["a","b"]}';
try {
var obj = JSON.parse(jsonStr);
console.log(obj.name); // "張三"
} catch (e) {
console.error("JSON 格式錯誤:", e.message);
}
// 使用 reviver 轉換日期字串為 Date 物件
var obj2 = JSON.parse(jsonStr, function(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;
});
| 錯誤 | 原因 | 解決 |
|---|---|---|
| Converting circular structure to JSON | 物件有循環引用 | 用 replacer 過濾、或用 flatted 庫 |
| BigInt 序列化失敗 | JSON 不支援 BigInt | 轉為字串或 number:v => typeof v === 'bigint' ? v.toString() : v |
| undefined/function/symbol 丟失 | JSON 標準不支援這些類型 | replacer 中轉為字串,或預先處理 |
| 中文變 \uXXXX | 預設輸出 ASCII | 現代環境預設保留 Unicode,若需 ASCII 用 unescape/encodeURIComponent |
JSON.stringify 分批處理或 Web WorkertoJSON 方法JSON.stringify() / JSON.parse() 是現代前端資料處理的基石。掌握 replacer、reviver、toJSON() 進階用法,能靈活處理日期、循環引用、敏感欄位過濾等實務需求。新專案建議搭配 TypeScript 介面定義與 Zod 等驗證庫,建立型別安全的資料流管線。