萬盛學電腦網

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

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

語法簽名


jQuery.extend([deep], target, object1 [, objectN])
// deep: Boolean,true = 深拷貝(遞歸合併巢狀物件/陣列)
// target: 接收合併結果的物件(會被修改並返回)
// object1...objectN: 來源物件,後者屬性覆蓋前者

核心行為

  • 淺拷貝(預設):第一層屬性覆蓋,巢狀物件/陣列共享引用
  • 深拷貝(deep=true):遞歸合併巢狀結構,建立新引用
  • 未定義屬性不複製:`undefined` 屬性會被跳過
  • 原型鏈屬性會被複製:`for...in` 遍歷包含繼承屬性
  • 目標物件為空物件 `{}` 可避免污染來源

實戰範例

1. 合併配置選項(插件開發常用)


function Plugin(options) {
  const defaults = {
    url: '/api',
    timeout: 5000,
    retry: 3,
    headers: {'Content-Type': 'application/json'}
  };
  // 合併:預設值為基礎,使用者選項覆蓋
  this.config = $.extend(true, {}, defaults, options);
  // true: 深拷貝 headers 等巢狀物件
  // {}: 新物件,不修改 defaults
}

2. 多物件合併(後者勝出)


const base = {a: 1, b: {x: 10}};
const override1 = {b: {y: 20}, c: 3};
const override2 = {b: {z: 30}, d: 4};

const result = $.extend(true, {}, base, override1, override2);
console.log(result);
// {a:1, b:{x:10, y:20, z:30}, c:3, d:4}
// 深拷貝下,b 物件屬性被合併而非整體替換

3. 淺拷貝陷阱


const a = {items: [1,2]};
const b = $.extend({}, a); // 淺拷貝
b.items.push(3);
console.log(a.items); // [1,2,3] !原陣列被修改

// 正確:深拷貝
const c = $.extend(true, {}, a);
c.items.push(4);
console.log(a.items); // [1,2,3] 不受影響

4. 陣列合併行為(非陣列連接)


$.extend(true, {arr: [1,2]}, {arr: [3,4]}); 
// 結果: {arr: [3,4]} —— 陣列被整體替換,不合併元素
// 如需合併陣列:$.merge([], arr1, arr2) 或 [...arr1, ...arr2]

原始碼核心邏輯(簡化版)


function extend() {
  let deep = false, target = arguments[0], i = 1;
  if (typeof target === 'boolean') { deep = target; target = arguments[1]; i = 2; }
  if (typeof target !== 'object' && !isFunction(target)) target = {};
  
  for (; i < arguments.length; i++) {
    const src = arguments[i];
    if (!src) continue;
    for (const key in src) {
      if (src[key] === undefined) continue; // 跳過 undefined
      if (deep && isPlainObject(src[key]) && isPlainObject(target[key])) {
        target[key] = extend(true, target[key], src[key]); // 遞歸
      } else if (src[key] !== undefined) {
        target[key] = src[key]; // 直接賦值(覆蓋或新增)
      }
    }
  }
  return target;
}

常見誤區與最佳實踐

誤區正確做法
直接修改 defaults 物件用 `{}` 作為 target:`$.extend(true, {}, defaults, options)`
期望陣列合併元素用 `$.merge()` 或展開運算子 `[...a, ...b]`
深拷貝循環引用物件會導致無限遞歸,需用 Lodash `_.cloneDeep` 或自帶 WeakMap 檢測
合併含有 getter/setter 的物件$.extend 只複製值,不保留存取器,需用 Object.defineProperty 手動處理

現代替代方案


// ES6 淺合併
const merged = {...defaultConfig, ...userConfig};

// 深合併:Lodash _.merge(處理循環引用、型別更嚴謹)
import {merge} from 'lodash-es';
const deepMerged = merge({}, defaultConfig, userConfig);

// Object.assign(淺拷貝,不支援深度)
Object.assign({}, defaultConfig, userConfig);

總結

$.extend() 是 jQuery 時代物件合併的標準工具,深拷貝能力在配置合併場景極具價值。現代開發中,淺合併優先用展開運算子,深合併推薦 Lodash `_.merge`(更健壯、支援 ESM、Tree-shaking)。理解 `$.extend` 行為細節,對維護舊專案、閱讀 jQuery 系插件源碼仍有重要參考價值。

copyright © 萬盛學電腦網 all rights reserved