含義:Object.assign方法用於對象的合並,將源對象(source)的所有可枚舉屬性,復制到目標對象(target)
1 const target = { a: 1 }; 2
3 const source1 = { b: 2 }; 4 const source2 = { c: 3 }; 5
6 Object.assign(target, source1, source2); 7 target // {a:1, b:2, c:3}
Object.assgin方法的第一個參數是目標對象,后面的參數都是源對象。
注意:如果目標對象與源對象有同名屬性,或多個源對象有同名屬性,則后面的屬性會覆蓋前面的屬性。
1 const target = { a: 1, b: 1 }; 2
3 const source1 = { b: 2, c: 2 }; 4 const source2 = { c: 3 }; 5
6 Object.assign(target, source1, source2); 7 target // {a:1, b:2, c:3}
如果只有一個參數,Object.assign會直接返回該參數。
1 const obj = {a: 1}; 2 Object.assign(obj) === obj // true
由於undefined和null 無法轉成對象,所以如果她們作為參數,就會報錯。
Object.assign(undefined) // 報錯
Object.assign(null) // 報錯
如果非對象參數出現在源對象的位置(即數值、字符串、布爾值)不在首參數,也不會報錯。
但是,除了字符串會以數組形式,拷貝入目標對象,其他值都不會產生效果。
1 const v1 = 'abc'; 2 const v2 = true; 3 const v3 = 10; 4
5 const obj = Object.assign({}, v1, v2, v3); 6 console.log(obj); // { "0": "a", "1": "b", "2": "c" }
上面代碼中,v1、v2、v3分別是字符串、布爾值、和數值,結果只有字符串入目標對象(以字符數組的形式),
數值和布爾值都會被忽略、這是因為只有字符串的包裝對象,會產生可枚舉屬性
1 Object(true) // {[[PrimitiveValue]]: true}
2 Object(10) // {[[PrimitiveValue]]: 10}
3 Object('abc') // {0: "a", 1: "b", 2: "c", length: 3, [[PrimitiveValue]]: "abc"}
上面代碼中,布爾值、數值、字符串分別轉成對應的包裝對象,可以看到他們的原始值都在包裝對象的內部屬性
[[PrimitiveValue]] 上面,這個屬性是不會被Object.assign拷貝的。只有字符串的包裝對象,會產生可枚舉的實義屬性
,那些屬性則會被拷貝
Object.assign拷貝的屬性是有限制的,只拷貝源對象的自身屬性(不拷貝繼承屬性),也不拷貝不可枚舉的屬性(enumerable: false)
1 Object.assign({b: 'c'}, 2 Object.defineProperty({}, 'invisible', { 3 enumerable: false, 4 value: 'hello'
5 }) 6 ) 7 // { b: 'c' }
上面代碼中,Object.assign要拷貝的對象只有一個不可枚舉屬性invisible,這個屬性並沒有被拷貝進去
屬性名為Symbol值的屬性,也會被Object.assign拷貝。
1 Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' }) 2 // { a: 'b', Symbol(c): 'd' }
以下需要特別注意
淺拷貝
object.assign方法實行的是淺拷貝,而不是深拷貝。也就是說,如果源對象某個屬性的值是對象,
那么目標對象拷貝得到的是這個對象的引用。
1 const obj1 = {a: {b: 1}}; 2 const obj2 = Object.assign({}, obj1); 3
4 obj1.a.b = 2; 5 obj2.a.b // 2
上面代碼中,源對象obj1的a屬性的值是一個對象,Object.assign拷貝得到的是這個對象的引用。這個對象的任何變化,都會反映到目標對象上面。
同名屬性的替換
對於這種嵌套的對象,一旦遇到同名屬性,Object.assign的處理方法是替換,而不是添加。
1 const target = { a: { b: 'c', d: 'e' } } 2 const source = { a: { b: 'hello' } } 3 Object.assign(target, source) 4 // { a: { b: 'hello' } }
上面代碼中,target對象的a屬性被source對象的a屬性整個替換掉了,而不會得到{ a: { b: 'hello', d: 'e' } }的結果。這通常不是開發者想要的,需要特別小心。
一些函數庫提供 Object.assign的定制版本(比如 Lodash 的_.defaultsDeep方法),可以得到深拷貝的合並。
數組的處理
object.assign可以用來處理數組,但是會把數組視為對象。
1 Object.assign([1, 2, 3], [4, 5]) 2 // [4, 5, 3]
常見用途
為對象添加屬性
1 class Point { 2 constructor(x, y) { 3 Object.assign(this, {x, y}); 4 } 5 }
上面方法通過Object.assign方法,將x屬性和y屬性添加到Point類的對象實例
為對象添加方法
1 Object.assign(SomeClass.prototype, { 2 someMethod(arg1, arg2) { 3 ··· 4 }, 5 anotherMethod() { 6 ··· 7 } 8 }); 9
10 // 等同於下面的寫法
11 SomeClass.prototype.someMethod = function (arg1, arg2) { 12 ··· 13 }; 14 SomeClass.prototype.anotherMethod = function () { 15 ··· 16 };
上面代碼使用了對象屬性的簡潔表示法,直接將兩個函數放在大括號中,再使用assign方法添加到SomeClass.prototype之中。
合並多個對象
將多個對象合並到某個對象
1 const merge = (target, ...sources) => Object.assign(target, ...sources);
如果希望合並后返回一個新對象,可以改寫上面函數,對一個空對象合並。
1 const merge = (...sources) => Object.assign({}, ...sources);
為屬性指定默認值
1 const DEFAULTS = { 2 logLevel: 0, 3 outputFormat: 'html'
4 }; 5
6 function processContent(options) { 7 options = Object.assign({}, DEFAULTS, options); 8 console.log(options); 9 // ...
10 }
上面代碼中,DEFAULTS對象是默認值,options對象是用戶提供的參數。Object.assign方法將DEFAULTS和options合並成一個新對象,如果兩者有同名屬性,則option的屬性值會覆蓋DEFAULTS的屬性值。
注意,由於存在淺拷貝的問題,DEFAULTS對象和options對象的所有屬性的值,最好都是簡單類型,不要指向另一個對象。否則,DEFAULTS對象的該屬性很可能不起作用
