萬盛學電腦網

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

jQuery.extend() 深度解析:淺拷貝、深拷貝、多源合併與插件開發實戰

$.extend() 是 jQuery 核心工具方法,廣泛用於選項合併、預設值填充、物件複製、插件配置管理。本文系統解析其三種呼叫簽名、淺/深拷貝行為差異、陷阱與插件開發實戰模式。

三種呼叫簽名

1. 多源合併至目標物件 (修改目標)

$.extend(target, source1, source2, ...);
// 返回合併後的 target (原 target 被修改)

2. 合併至新物件 (不修改來源,推薦)

const merged = $.extend({}, source1, source2, source3);
// {} 作為空目標,來源物件保持不變

3. 深拷貝模式 (第一參數為 boolean)

$.extend(true, target, source1, source2, ...);
// true → 深度遞迴合併巢狀物件/陣列
// false (預設) → 淺拷貝,僅第一層屬性覆蓋

淺拷貝 vs 深拷貝:關鍵差異

const defaults = {
  user: { name: 'Guest', prefs: { theme: 'light' } },
  items: [1, 2]
};

const options = {
  user: { name: 'Admin', prefs: { lang: 'zh' } },
  items: [3, 4]
};

// 淺拷貝 (預設)
const shallow = $.extend({}, defaults, options);
/* 結果:
{
  user: { name: 'Admin', prefs: { lang: 'zh' } },  // 整個 user.prefs 被替換!
  items: [3, 4]                                     // 陣列整個替換
}
*/

// 深拷貝
const deep = $.extend(true, {}, defaults, options);
/* 結果:
{
  user: { 
    name: 'Admin', 
    prefs: { theme: 'light', lang: 'zh' }  // prefs 合併!
  },
  items: [3, 4]  // 陣列仍整個替換 (jQuery 不合併陣列元素)
}
*/

關鍵行為細節

情況行為說明
後方來源屬性為 undefined忽略,不覆蓋可用於「選填配置」
陣列合併整個替換不合併元素,非深度合併
循環引用拋錯 / 無限遞迴jQuery 無內建檢測,需自行處理
原型鏈屬性不複製僅枚舉自有屬性
null/undefined 來源忽略安全

插件開發標準模式

;(function($) {
  $.fn.myPlugin = function(options) {
    // 1. 定義預設值
    const defaults = {
      color: 'blue',
      speed: 300,
      easing: 'swing',
      callbacks: {
        onStart: $.noop,
        onComplete: $.noop
      }
    };
    
    // 2. 深度合併用戶選項 (不修改 defaults)
    const settings = $.extend(true, {}, defaults, options);
    
    // 3. 使用 settings
    return this.each(function() {
      const $el = $(this);
      $el.animate({ color: settings.color }, settings.speed, settings.easing, 
        () => settings.callbacks.onComplete.call(this));
    });
  };
})(jQuery);

// 使用
$('.box').myPlugin({
  color: 'red',
  callbacks: { onComplete: () => console.log('Done!') }
  // speed, easing, callbacks.onStart 自動使用預設值
});

進階:陣列合併策略 (jQuery 不支援,需自行實現)

function mergeArrays(target, source) {
  // 策略 1:替換 (jQuery 預設)
  // 策略 2:串聯
  return target.concat(source);
  // 策略 3:去重串聯
  return [...new Set([...target, ...source])];
  // 策略 4:按索引合併物件
  return source.map((item, i) => $.extend(true, {}, target[i], item));
}

// 自定義深度合併支援陣列策略
function deepMerge(target, source, arrayStrategy = 'replace') {
  // 實作略...
}

現代替代方案對比

方法深拷貝陣列合併備註
$.extend(true, {}, ...)✅替換jQuery 依賴
Object.assign({}, ...)❌ 淺層替換ES6 原生
{...a, ...b}❌ 淺層替換ES2018 展開語法
lodash.merge()✅替換功能最全、體積大
deepmerge (npm)✅可配置輕量、專注合併
structuredClone()✅ 完整克隆N/A現代原生、不合併

避坑指南

  1. ❌ $.extend(defaults, options) 會汙染預設值 → ✅ $.extend(true, {}, defaults, options)
  2. ❌ 合併含循環引用的物件 → ✅ 先清理或用 lodash.mergeWith 自定義
  3. ❌ 期望陣列自動合併 → ✅ 明確處理陣列或用支援陣列策略的庫
  4. ❌ 用於 DOM 元素/Window 等宿主物件 → ✅ 僅用於純 JS 物件

原理簡析 (簡化版)

function extend() {
  const args = Array.from(arguments);
  let deep = false, target = {}, i = 0;
  
  if (typeof args[0] === 'boolean') { deep = args.shift(); }
  target = args.shift() || {};
  
  args.forEach(source => {
    if (!source) return;
    Object.keys(source).forEach(key => {
      const srcVal = source[key];
      if (srcVal === undefined) return;
      
      if (deep && isPlainObject(srcVal)) {
        target[key] = extend(true, 
          isPlainObject(target[key]) ? target[key] : {}, 
          srcVal
        );
      } else if (deep && Array.isArray(srcVal)) {
        target[key] = srcVal.slice(); // 陣列淺拷貝
      } else {
        target[key] = srcVal;
      }
    });
  });
  return target;
}

$.extend() 雖非標準 API,但其「選項合併」語意極契合插件開發。理解其深/淺拷貝邊界,能避免配置汙染、狀態異常等隱蔽 Bug。

copyright © 萬盛學電腦網 all rights reserved