萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

$.extend 陷阱:原型鏈污染導致 Worker postMessage 失效的排查實錄

現象:Worker 傳遞大對象拋出 DataCloneError

移動端項目使用 Zepto(jQuery 兼容子集)開發,引入 Array.prototype.foreach 兼容 forEach 中斷語義。後引入 Web Worker 異步 JSON.stringify 大對象(20MB+),worker.postMessage(data) 拋出:


Uncaught DataCloneError: Failed to execute 'postMessage' on 'Worker': An object could not be cloned.

排查過程

  1. 對象結構檢查:console.dir(data) 發現數組對象上多出 foreach 函數屬性。
  2. 定位污染源:代碼中使用 $.extend(true, {}, obj) 深拷貝,Zepto extend 實現使用 for...in 遍歷源對象,**未檢查 hasOwnProperty**,導致原型鏈上的 foreach 被拷貝到目標對象。
  3. 驗證 jQuery 同樣問題:檢視 jQuery 3.x 源碼,extend 內部同樣只有 copy !== undefined 判斷,**無 hasOwnProperty 過濾**,同樣會拷貝可枚舉原型屬性。

根因分析:for...in 遍歷可枚舉原型屬性


// Zepto 簡化版 extend
function extend(target, source, deep) {
    for (key in source) {                    // 遍歷自身+原型鏈可枚舉屬性
        if (deep && (isPlainObject(source[key]) || isArray(source[key]))) {
            // 遞歸深拷貝
        } else if (source[key] !== undefined) {
            target[key] = source[key]        // 直接賦值,污染目標
        }
    }
}

Array.prototype.foreach = ... 使 foreach 成為所有數組的可枚舉屬性,for...in 會遍歷到它,extend 將其拷貝到新對象,導致對象包含函數屬性,**結構化克隆算法不支援函數**,故 postMessage 失敗。

解決方案對比

方案代碼修改優點缺點
1. 刪除原型擴展移除 Array.prototype.foreach徹底根治失去便利語法,需改用輔助函數
2. 使用 Object.defineProperty 定義不可枚舉Object.defineProperty(Array.prototype, 'foreach', {value: fn, enumerable: false})保留語法,不被 for...in 遍歷IE8- 不支援,代碼稍繁瑣
3. 替換為 lodash.cloneDeep / 自寫深拷貝引入 lodash 或實現 hasOwnProperty 過濾可控、無副作用增加依賴/代碼量
4. Worker 傳輸前清洗JSON.parse(JSON.stringify(data)) 序列化去除函數零業務代碼改動大對象雙重序列化效能損耗大

推薦最佳實踐

  1. 嚴禁修改內建原型:Array.prototype, Object.prototype, Function.prototype 等。現代 ES6+ 提供 Array.from, ...spread, for...of, Array.prototype.find/findIndex 等原生替代。
  2. 必須擴展時:使用 Object.defineProperty(..., {enumerable: false}) 或 Symbol 鍵。
  3. 深拷貝選型:
    • 簡單數據:JSON.parse(JSON.stringify(obj))(丟失函數/RegExp/Date/循環引用)。
    • 通用深拷貝:lodash.cloneDeep(生產級、處理循環引用、Symbol、原型鏈)。
    • 自寫遞歸:僅處理純對象/數組,Object.prototype.hasOwnProperty.call(source, key) 過濾。
  4. Worker 傳輸優化:大對象使用 Transferable(ArrayBuffer, MessagePort, ImageBitmap)零拷貝轉移所有權,或 CompressionStream 壓縮後傳輸。

自寫安全深拷貝參考實現


function safeDeepClone(obj, hash = new WeakMap()) {
    if (obj === null || typeof obj !== 'object') return obj;
    if (obj instanceof Date) return new Date(obj);
    if (obj instanceof RegExp) return new RegExp(obj);
    if (hash.has(obj)) return hash.get(obj); // 循環引用

    const clone = Array.isArray(obj) ? [] : Object.create(Object.getPrototypeOf(obj));
    hash.set(obj, clone);

    for (const key in obj) {
        if (Object.prototype.hasOwnProperty.call(obj, key)) {
            clone[key] = safeDeepClone(obj[key], hash);
        }
    }
    // Symbol keys
    Object.getOwnPropertySymbols(obj).forEach(sym => {
        clone[sym] = safeDeepClone(obj[sym], hash);
    });
    return clone;
}

總結

$.extend 看似便利,實則隱藏「原型鏈污染」隱患。**現代前端開發應堅守「不修改內建原型」原則**,拥抱 ES6+ 標準 API,深拷貝選用成熟庫(lodash/rfdc),Worker 傳輸大數據採用 Transferable 或壓縮流。此坑曾讓無數開發者折騰數小時,記住核心原因:**for...in + 可枚舉原型屬性 = 污染目標對象**。

copyright © 萬盛學電腦網 all rights reserved