ECShop 這類老項目裡,transport.js 與 jQuery 同場運行時經常出各種詭異問題。追下去,根源往往就一行代碼。
在 /js/transport.js 大約第 580 到 590 行之間,有這麼一段:
Object.prototype.toJSONString = function () { ************** }
它的用途是把對象格式化為 JSON 字符串。問題不在功能,而在掛載位置——它被直接擴充到了 Object.prototype 上。這意味著頁面裡每一個對象都會多出 toJSONString 這個可枚舉屬性,而 jQuery 內部大量使用 for...in 遍歷對象。於是遍歷時多出一個本不該存在的鍵,框架邏輯就被帶偏了。
這也是經典反模式之一:不要修改內建對象的原型,除非你非常清楚會波及哪些代碼。
把這段原型擴充註釋掉,然後用一個獨立工具函數取代所有 *.toJSONString() 的呼叫點。
例如 /js/common.js 第 29 行原本是:
Ajax.call('flow.php?step=add_to_cart', 'goods=' + goods.toJSONString, addToCartResponse, 'POST', 'JSON');
改為:
Ajax.call('flow.php?step=add_to_cart', 'goods=' + obj2str(goods), addToCartResponse, 'POST', 'JSON');
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 == "undefined") return "undefined";
if (typeof o == "object") {
if (o === null) {
return "null";
} else if (!o.sort) {
// 普通對象
for (var i in o) {
r.push("\"" + i + "\"" + ":" + obj2str(o[i]));
}
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();
}
思路是手寫一次遞歸序列化:字符串做轉義,數組靠 sort 方法是否存在來與普通對象區分,其餘類型走 toString()。
/*
Object.prototype.toJSONString = function () {
......
// Join all of the fragments together and return.
a.push('}');
return a.join("");
};
*/
這個方案並非放之四海皆準,不同站點的調用方式差異很大,接入後仍可能有零星的兼容性問題需要逐一處理,這裡提供的只是一條可行的路徑。
如果項目環境允許,更省事的做法是直接引入官方的 JSON 庫(如 json2.js),用標準的 JSON.stringify() 取代自造的 obj2str;現代瀏覽器更是已原生支持,完全不必再自己造輪子。
不過真正的教訓在於:永遠不要為了圖方便去改 Object.prototype。它帶來的衝突往往隱蔽且難以定位,代價遠高於一開始就把工具函數寫成獨立形式的成本。