DIV CSS 佈局教程網

把 Object 轉成字串的 JavaScript 實作:一個手刻的序列化函式
編輯:關於JavaScript     

在 JSON.stringify 普及之前,要在 JavaScript 中把物件轉成字串得自己動手。這份 obj2str 就是那個年代的產物,它示範了序列化需要處理哪些邊界情況。

function obj2str(o){
  var r = [];

  // 字串:加上引號並跳脫特殊字元
  if (typeof o == "string")
    return "\"" + o.replace(/([\'\"\\])/g, "\\$1")
                   .replace(/(\n)/g, "\\n")
                   .replace(/(\r)/g, "\\r")
                   .replace(/(\t)/g, "\\t") + "\"";

  if (typeof o == "object"){
    if (!o.sort){                       // 不是陣列 → 當物件處理
      for (var i in o) r.push(i + ":" + obj2str(o[i]));

      // 舊 IE 中 toString 若被覆寫過,會被 for...in 列舉出來,需特別處理
      if (!!document.all
          && !/^\n?function\s*toString\(\)\s*\{\n?\s*\[native code\]\n?\s*\}\n?\s*$/.test(o.toString)){
        r.push("toString:" + o.toString.toString());
      }
      r = "{" + r.join() + "}";
    } else {                            // 是陣列
      for (var i = 0; i < o.length; i++) r.push(obj2str(o[i]));
      r = "[" + r.join() + "]";
    }
    return r;
  }
  return o.toString();                  // 其他型別直接轉字串
}

它在處理的四個問題

  1. 型別分派:字串、物件、陣列各自走不同分支,其餘型別一律 toString()。
  2. 字串跳脫:反斜線、雙引號、單引號、換行、回車、定位字元都必須轉義,否則輸出的字串會被誤解析。
  3. 陣列與物件的偵測:用 o.sort 是否存在來判斷——這是當時常見的鴨子比對技巧。
  4. IE 的 toString 難題:舊版 IE 中若物件覆寫了 toString,for...in 會把它也列舉出來,導致輸出多出一個不該有的欄位。程式用一段正則比對 [native code] 來判斷是否為原生實作,並在非原生時特別補上。

這份實作的極限

它有不少明顯的破綻,而這些破綻恰好說明了「序列化」為什麼不是一件簡單的事:

  • 循環參照會造成無限遞迴。若 obj.self = obj,這個函式會直接堆疊溢出。
  • 函式與 undefined 沒有處理。在物件中遇到 function 時會走到 toString() 分支,輸出整段函式原始碼,這幾乎不會是你想要的。
  • 原型鏈上的屬性會被一併輸出。for...in 會列舉繼承來的可列舉屬性。
  • 日期物件會被當普通物件拆解,輸出一堆沒有意義的內部欄位。
  • 沒有 query 字串解析能力,輸出的格式不是 JSON(欄位名沒有加引號),只能自己用。

今天的答案

直接用原生 API,一行取代以上全部:

const str = JSON.stringify(obj);

// 處理循環參照:用 replacer 加一組 Seen 集合
const seen = new WeakSet();
const safe = JSON.stringify(obj, function(key, value){
  if (typeof value === 'object' && value !== null){
    if (seen.has(value)) return '[Circular]';
    seen.add(value);
  }
  return value;
});

// 反解回物件
const back = JSON.parse(str);

需要注意的原生行為差異:JSON.stringify 會自動跳過函数值與 undefined 屬性(在陣列中則轉為 null),遇到 BigInt 會拋出 TypeError,而 Date 會依 toJSON 轉成 ISO 字串——這些行為都是有文件化的約定,比手刻版本可靠得多。

這份老程式碼值得一读的理由,是它讓你明白序列化本質上是在定義一套「型別與文字之間的雙向約定」。約定要處理跳脫、要處理型別標記、要處理參照關係、還要處理無法表達的值。理解這些邊界條件,你用 JSON.stringify 時才知道它幫你擋掉了多少麻煩。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved