前後端交互中,JSON 對象與字符串頻繁轉換。現代瀏覽器原生 JSON.stringify()/JSON.parse()、jQuery .parseJSON()、舊 IE 需 json2.js 或 eval()。本文系統整理各環境下的轉換方法、陷阱與最佳實踐。
// 對象 -> 字符串
var obj = { name: "Tom", age: 25, skills: ["JS", "Java"] };
var str = JSON.stringify(obj);
// '{"name":"Tom","age":25,"skills":["JS","Java"]}'
// 字符串 -> 對象
var obj2 = JSON.parse(str);
// {name:"Tom", age:25, skills:["JS","Java"]}
// 進階:replacer / reviver
var str2 = JSON.stringify(obj, ['name', 'age']); // 只序列化指定屬性
var obj3 = JSON.parse(str, (k, v) => k === 'age' ? v + 1 : v); // 反序列化時轉換
// 僅解析,無序列化
var obj = $.parseJSON('{"name":"Tom"}'); // 等同 JSON.parse,但更嚴格要求標準 JSON 格式
// 手動擴展序列化(不推薦,直接用原生)
$.stringifyJSON = function (obj) { return JSON.stringify(obj); };
<!--[if lt IE 9]>
<script src="https://cdn.jsdelivr.net/npm/json2@latest/json2.js"></script>
<![endif]-->
// 引入後全域即可用 JSON.stringify / JSON.parse
var str = '{"name":"Tom"}';
var obj = eval('(' + str + ')'); // 必須包裹括號,防止語句解析錯誤
// 風險:若字符串包含惡意代碼將被執行,嚴禁用於不可信數據
var users = [{id:1,name:'A'},{id:2,name:'B'}];
$.ajax({
url: '/api/users/batch',
type: 'POST',
contentType: 'application/json; charset=utf-8',
data: JSON.stringify(users), // 直接發送 JSON 字符串
success: function(res) { ... }
});
// Java 後端常返回 /Date(1700000000000)/
var dateStr = "/Date(1700000000000)/";
var timestamp = parseInt(dateStr.replace(/\D/g, ''), 10);
var date = new Date(timestamp);
var json = '{"id": 9007199254740993}'; // 超過 2^53
var obj = JSON.parse(json);
console.log(obj.id); // 9007199254740992 (精度丟失)
// 解決:後端以字符串傳輸大整數,或前端使用 JSON.parse + reviver 配合 BigInt
| 錯誤 | 原因 | 修正 |
|---|---|---|
| JSON.parse 報 SyntaxError | 字符串非標準 JSON(單引號、尾逗號、註釋) | 後端輸出標準 JSON;或用宽鬆解析庫(如 json5) |
| 字符串中包含換行/制表符 | 未轉義 | JSON.stringify 自動轉義;手動拼接時需轉義 |
| 循環引用導致 TypeError | 對象結構有環 | 使用 JSON.stringify(obj, (k,v)=> seen.has(v)? undefined : (seen.add(v),v)) 或專用庫 |
| 日期對象序列化為 ISO 字符串 | JSON.stringify 內部調用 toJSON() | 後端解析 ISO 格式,或自定義 toJSON 返回時間戳 |
JSON.stringify/parse,項目入口引入 json2.js 兼容舊 IE。Content-Type: application/json; charset=utf-8。掌握各環境下的 JSON 轉換方式,構建健壯的前後端數據交換通道。