jQuery.extend([deep], target, object1 [, objectN])
// deep: Boolean,true = 深拷貝(遞歸合併巢狀物件/陣列)
// target: 接收合併結果的物件(會被修改並返回)
// object1...objectN: 來源物件,後者屬性覆蓋前者
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
}
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 物件屬性被合併而非整體替換
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] 不受影響
$.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 系插件源碼仍有重要參考價值。