萬盛學電腦網

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

JavaScript/jQuery JSON 字串與物件互轉完整指南:JSON2.js、原生 API 與最佳實踐

核心 API 對照

操作原生標準 API (IE8+)JSON2.js (舊瀏覽器相容)jQuery
物件 → 字串JSON.stringify(obj)JSON.stringify(obj)無內建,需外掛
字串 → 物件JSON.parse(str)JSON.parse(str)$.parseJSON(str) (3.0 棄用)

一、原生 JSON API 詳解 (現代標準,推薦)

JSON.stringify() - 物件序列化為字串

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)

replacer 參數 - 過濾/轉換屬性

// 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}'

space 參數 - 美化輸出

// 數字:縮排空格數
JSON.stringify(obj, null, 2);
// 輸出含換行縮排的美化字串

// 字串:自定義縮排字元 (如 tab)
JSON.stringify(obj, null, '\t');

toJSON() 方法 - 物件自定義序列化

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..."}'

JSON.parse() - 字串解析為物件

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 (json2.js) 是 Douglas Crockford 編寫的 Polyfill,為 **IE6/IE7** 提供 JSON 支援。現代專案 (IE8+) **無需引入**,原生 API 已完整支援。

何時仍需 JSON2.js

  • 維護必須支援 IE6/IE7 的舊專案
  • 特殊嵌入式瀏覽器環境 (舊版 WebView、智慧型電視、POS 系統)

引入方式

<!-- 條件註解僅 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 最頂部引入

三、jQuery 相關方法

$.parseJSON() (jQuery 1.4.1+ ~ 2.x/3.x)

// 等同 JSON.parse(),但會拋出較友善的錯誤訊息
var obj = $.parseJSON('{"a":1}');

// jQuery 3.0+ 棄用,建議直接用 JSON.parse()

jQuery 模板引擎 (jquery.tmpl.js) 中的 JSON 處理

<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 官方已停止維護,建議改用現代模板引擎

四、常見錯誤與解決方案

1. 循環引用錯誤

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));

2. 大數字精度丟失

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)

3. 日期格式不一致

// 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() 解析 JSON
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。

copyright © 萬盛學電腦網 all rights reserved