萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JSON 對象與字符串雙向轉換完整指南:原生 API、jQuery、兼容舊 IE 方案

前後端交互中,JSON 對象與字符串頻繁轉換。現代瀏覽器原生 JSON.stringify()/JSON.parse()、jQuery .parseJSON()、舊 IE 需 json2.js 或 eval()。本文系統整理各環境下的轉換方法、陷阱與最佳實踐。

1. 現代瀏覽器原生 API(IE8+ 標準模式、所有現代瀏覽器)

// 對象 -> 字符串
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); // 反序列化時轉換

2. jQuery 輔助方法

// 僅解析,無序列化
var obj = $.parseJSON('{"name":"Tom"}'); // 等同 JSON.parse,但更嚴格要求標準 JSON 格式

// 手動擴展序列化(不推薦,直接用原生)
$.stringifyJSON = function (obj) { return JSON.stringify(obj); };

3. 舊 IE (IE6/7/8 兼容模式) 兼容方案

3.1 引入 json2.js(標準 Polyfill,推薦)

<!--[if lt IE 9]>
<script src="https://cdn.jsdelivr.net/npm/json2@latest/json2.js"></script>
<![endif]-->
// 引入後全域即可用 JSON.stringify / JSON.parse

來源:douglascrockford/JSON-js

3.2 eval() 方案(不推薦,安全風險)

var str = '{"name":"Tom"}';
var obj = eval('(' + str + ')'); // 必須包裹括號,防止語句解析錯誤
// 風險:若字符串包含惡意代碼將被執行,嚴禁用於不可信數據

4. 前後端交互實戰場景

場景一:前端發送對象數組

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

5. 常見錯誤與避坑

錯誤原因修正
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 返回時間戳

6. 最佳實踐清單

  1. 統一使用 JSON.stringify/parse,項目入口引入 json2.js 兼容舊 IE。
  2. 傳輸層設置 Content-Type: application/json; charset=utf-8。
  3. 大整數(>253) 傳字符串,避免精度丟失。
  4. 日期統一用 ISO 8601 字符串或時間戳(毫秒數)。
  5. 敏感數據勿放入 JSON 傳輸,或加密後傳輸。

掌握各環境下的 JSON 轉換方式,構建健壯的前後端數據交換通道。

copyright © 萬盛學電腦網 all rights reserved