DIV CSS 佈局教程網

transport.js 與 jQuery 衝突的成因與解法
編輯:關於JavaScript     

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

替換用的 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 == "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。它帶來的衝突往往隱蔽且難以定位,代價遠高於一開始就把工具函數寫成獨立形式的成本。

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