萬盛學電腦網

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

JavaScript 生成 JSON 資料完整指南:從物件建立到序列化最佳實踐

JSON 簡介

JSON (JavaScript Object Notation) 是輕量級資料交換格式,易於人閱讀、機器解析。現代 Web 開發中,前後端資料傳輸、設定檔、API 回應幾乎都使用 JSON。

基本建立方式

1. 物件字面量 → JSON 字串

// 定義物件
var finalInfo = {
  purchaseInfoId: "",
  purchaseMethodType: "",
  contact: "",
  contactTel: "",
  bidInfoStr: ""
};

// 序列化為 JSON 字串
var finalInfoStr = JSON.stringify(finalInfo);
// 結果:'{"purchaseInfoId":"","purchaseMethodType":"","contact":"","contactTel":"","bidInfoStr":""}'

2. 動態建構物件

var data = {};
data.id = 123;
data.name = "產品名稱";
data.tags = ["熱銷", "推薦"];
data.price = 999;
data.inStock = true;

var jsonStr = JSON.stringify(data);

3. 從表單自動收集生成 JSON

$.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();

JSON.stringify 進階參數

美化輸出(縮排)

var obj = { a: 1, b: { c: 2 } };
JSON.stringify(obj, null, 2);  // 第三參數:縮排空格數
// 結果:
// {
//   "a": 1,
//   "b": {
//     "c": 2
//   }
// }

自訂序列化邏輯(replacer 函式)

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

toJSON() 方法自訂物件序列化

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)格式化後再序列化

解析 JSON 字串

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 Worker
  • 頻繁序列化相同結構物件,可預先定義 toJSON 方法
  • 傳輸前考慮壓縮(gzip/brotli),JSON 文字壓縮率極高

現代替代方案

  • Protocol Buffers / MessagePack:二進位格式,體積更小、解析更快,適合高頻 API
  • superjson:支援 Date、Set、Map、RegExp、undefined 等類型保真序列化
  • Zod / Valibot:Schema 驗證 + 序列化一體化

總結

JSON.stringify() / JSON.parse() 是現代前端資料處理的基石。掌握 replacer、reviver、toJSON() 進階用法,能靈活處理日期、循環引用、敏感欄位過濾等實務需求。新專案建議搭配 TypeScript 介面定義與 Zod 等驗證庫,建立型別安全的資料流管線。

copyright © 萬盛學電腦網 all rights reserved