萬盛學電腦網

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

JavaScript JSON 序列化與反序列化:原生 API、自定義實現與最佳實踐

現代標準:原生 JSON 對象

ES5+ 所有瀏覽器內建 `JSON`,**首選原生 API**,無需手寫序列化器。

const obj = { id: 3, name: 'abc', tags: ['a','b'], date: new Date() };

// 序列化
const str = JSON.stringify(obj);
// '{"id":3,"name":"abc","tags":["a","b"],"date":"2024-01-15T08:30:00.000Z"}'

// 反序列化
const parsed = JSON.parse(str);
// 注意:Date 會變為 ISO 字串,需手動轉換
parsed.date = new Date(parsed.date);

進階 JSON.stringify 選項

// 1. 格式化輸出(調試用)
JSON.stringify(obj, null, 2); // 縮進 2 空格

// 2. 過濾屬性:replacer 為陣列
JSON.stringify(obj, ['id', 'name']); // 只保留 id、name

// 3. 過濾/轉換:replacer 為函數
JSON.stringify(obj, (key, value) => {
  if (key === 'password') return undefined; // 排除敏感字段
  if (value instanceof Date) return value.toISOString(); // 統一日期格式
  return value;
});

// 4. toJSON() 方法:對象自定義序列化行為
const user = {
  name: 'Tom',
  password: 'secret',
  toJSON() {
    return { name: this.name }; // 自動排除 password
  }
};
JSON.stringify(user); // '{"name":"Tom"}'

自定義序列化器(教學/特殊需求)

原文提供的 `tools.j2s` 展示了手寫序列化的邏輯,現代場景**不建議生產使用**(效能差、邊界情況多、無 `toJSON` 支援),但理解其原理有助於面試與特殊場景(如需序列化 Function/RegExp/Date 為可執行代碼字串)。

核心邏輯解析

function customStringify(obj) {
  const type = Object.prototype.toString.call(obj).slice(8, -1); // [object Type] -> Type
  
  switch (type) {
    case 'Array':
      return '[' + obj.map(customStringify).join(',') + ']';
    case 'Object':
      return '{' + Object.keys(obj).map(k => 
        '"' + k + '":' + customStringify(obj[k])
      ).join(',') + '}';
    case 'String':
      return '"' + obj.replace(/["\\]/g, '\\$&') + '"'; // 轉義引號、反斜槓
    case 'Number':
    case 'Boolean':
      return String(obj);
    case 'Null':
      return 'null';
    case 'Date':
      return 'new Date(' + obj.getTime() + ')'; // 非標準 JSON,可執行還原
    case 'RegExp':
    case 'Function':
      return obj.toString(); // 非標準 JSON
    default:
      return 'null';
  }
}

反序列化:eval 風險與安全替代

原文使用 `eval('(' + str + ')')`,**極度危險**(任意代碼執行)。

安全方案

// 1. 標準 JSON:JSON.parse(唯一推薦)
const data = JSON.parse(jsonString);

// 2. 若字串包含非標準 JS 字面量(如 new Date()、RegExp、Function)
// 必須用專用解析器,或約定統一格式(如 ISO 日期字串)後手動轉換
function safeParse(str, reviver) {
  return JSON.parse(str, (key, value) => {
    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value)) {
      return new Date(value); // 自動轉日期
    }
    return reviver ? reviver(key, value) : value;
  });
}

// 3. 絕對禁止 eval 的場景
// eval('alert(1)') // XSS 攻擊入口

特殊類型處理對照表

類型JSON.stringify自定義 j2s還原建議
DateISO 字串new Date(ms)reviver 中 new Date()
RegExp{}(空對象)/pattern/flags新專案避免傳輸 RegExp
Function忽略function()...不傳輸函數,傳輸函數名/ID
undefined忽略undefined轉為 null 或約定字串
Symbol忽略忽略轉為字串描述
循環引用拋錯死遞歸用 flatted / circular-json

循環引用解決方案

// 使用 flatted (npm i flatted)
import { parse, stringify } from 'flatted';

const a = { name: 'a' };
a.self = a; // 循環引用

const str = stringify(a); // 正常序列化
const obj = parse(str);   // 正常反序列化,保持循環結構

效能優化建議

  • 大對象:分塊序列化、Web Worker 離屏序列化、或使用 JSONStream 流式處理。
  • 高頻調用:避免在熱路徑中 `JSON.stringify`,改用結構化克隆 `structuredClone(obj)`(現代瀏覽器)或預序列化緩存。
  • 傳輸壓縮:HTTP 層開啟 gzip/brotli,JSON 文本壓縮率極高(通常 >80%)。

結語

**生產環境請直接使用 `JSON.stringify` / `JSON.parse`**,配合 `toJSON()`、`replacer`、`reviver` 處理特殊類型。手寫序列化器僅供教學或極特殊需求(如需輸出可執行 JS 代碼)。牢記:**永遠不要用 `eval` 解析不可信字串**。

copyright © 萬盛學電腦網 all rights reserved