一、基本用法
1、Object.assign
方法用於對象的合並,將源對象(source)的所有可枚舉屬性,復制到目標對象(target)。
const target = { a: 1 }; const source1 = { b: 2 }; const source2 = { c: 3 }; Object.assign(target, source1, source2); target // {a:1, b:2, c:3}
Object.assign
方法的第一個參數是目標對象,后面的參數都是源對象。
2、注意,如果目標對象與源對象有同名屬性,或多個源對象有同名屬性,則后面的屬性會覆蓋前面的屬性。
const target = { a: 1, b: 1 }; const source1 = { b: 2, c: 2 }; const source2 = { c: 3 }; Object.assign(target, source1, source2); target // {a:1, b:2, c:3}
3、如果只有一個參數,Object.assign
會直接返回該參數。
const obj = {a: 1}; Object.assign(obj) === obj // true
4、如果該參數不是對象,則會先轉成對象,然后返回。
typeof Object.assign(2) // 'object'
Object.assign(2) // Number {2}
由於undefined
和null
無法轉成對象,所以如果它們作為參數,就會報錯。
Object.assign(undefined) // 報錯
Object.assign(null) // 報錯 // VM118021:1 Uncaught TypeError: Cannot convert undefined or null to object // at Function.assign (<anonymous>) // at <anonymous>:1:8
5、如果非對象參數出現在源對象的位置(即非首參數),那么處理規則有所不同。
(1)首先,這些參數都會轉成對象,如果無法轉成對象,就會跳過。這意味着,如果undefined
和null
不在首參數,就不會報錯。
let obj = {a: 1}; Object.assign(obj, undefined) === obj // true
Object.assign(obj, null) === obj // true
(2)其他類型的值(即數值、字符串和布爾值)不在首參數,也不會報錯。但是,除了字符串會以數組形式,拷貝入目標對象,其他值都不會產生效果。
const v1 = 'abc'; const v2 = true; const v3 = 10; const obj = Object.assign({}, v1, v2, v3); console.log(obj); // { "0": "a", "1": "b", "2": "c" }
上面代碼中,v1
、v2
、v3
分別是字符串、布爾值和數值,結果只有字符串合入目標對象(以字符數組的形式),數值和布爾值都會被忽略。這是因為只有字符串的包裝對象,會產生可枚舉屬性。(這個之前不清楚,需要了解一下喲)
Object(true) // {[[PrimitiveValue]]: true}
Object(10) // {[[PrimitiveValue]]: 10}
Object('abc') // {0: "a", 1: "b", 2: "c", length: 3, [[PrimitiveValue]]: "abc"}
上面代碼中,布爾值、數值、字符串分別轉成對應的包裝對象,可以看到它們的原始值都在包裝對象的內部屬性 [[PrimitiveValue]]
上面,這個屬性是不會被Object.assign
拷貝的。只有字符串的包裝對象,會產生可枚舉的實義屬性,那些屬性則會被拷貝。
6、Object.assign
拷貝的屬性是有限制的:
(1)只拷貝源對象的自身屬性(不拷貝繼承屬性),也不拷貝不可枚舉的屬性(enumerable: false
)。
Object.assign({b: 'c'}, Object.defineProperty({}, 'invisible', { enumerable: false, value: 'hello' }) ) // { b: 'c' }
上面代碼中,Object.assign
要拷貝的對象只有一個不可枚舉屬性invisible
,這個屬性並沒有被拷貝進去。
(2)屬性名為 Symbol 值的屬性,也會被Object.assign
拷貝。
Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' }) // { a: 'b', Symbol(c): 'd' }
二、需要注意的知識點
1、淺拷貝
Object.assign
方法實行的是淺拷貝,而不是深拷貝。也就是說,如果源對象某個屬性的值是對象,那么目標對象拷貝得到的是這個對象的引用。
const obj1 = {a: {b: 1}}; const obj2 = Object.assign({}, obj1); obj1.a.b = 2; obj2.a.b // 2
上面代碼中,源對象obj1
的a
屬性的值是一個對象,Object.assign
拷貝得到的是這個對象的引用。這個對象的任何變化,都會反映到目標對象上面。
2、同名屬性的替換
對於這種嵌套的對象,一旦遇到同名屬性,Object.assign
的處理方法是替換,而不是添加。
const target = { a: { b: 'c', d: 'e' } } const source = { a: { b: 'hello' } } Object.assign(target, source) // { a: { b: 'hello' } }
上面代碼中,target
對象的a
屬性被source
對象的a
屬性整個替換掉了(需要格外注意是不是自己想要的)
3、數組的處理
Object.assign
可以用來處理數組,但是會把數組視為對象。
Object.assign([1, 2, 3], [4, 5]) // [4, 5, 3]
這種就是把索引當做屬性,然后替換掉了,也需要特別注意下是不是自己想要的
4、取值函數的處理
Object.assign
只能進行值的復制,如果要復制的值是一個取值函數,那么將求值后再復制。
const source = { get foo() { return 1 } }; const target = {}; Object.assign(target, source) // { foo: 1 }
source
對象的foo
屬性是一個取值函數,Object.assign
不會復制這個取值函數,只會拿到值以后,將這個值復制過去。
三、常見應用場景
1、為對象添加屬性
class Point { constructor(x, y) { Object.assign(this, {x, y}); } } // 通過Object.assign方法,將x屬性和y屬性添加到Point類的對象實例
2、合並多個對象
(1)將多個對象合並到某個對象。
const merge = (target, ...sources) => Object.assign(target, ...sources);
(2)如果希望合並后返回一個新對象,可以改寫上面函數,對一個空對象合並。
const merge = (...sources) => Object.assign({}, ...sources);
3、為屬性指定默認值
const DEFAULTS = { logLevel: 0, outputFormat: 'html' }; function processContent(options) { options = Object.assign({}, DEFAULTS, options); // ...
}
上面代碼中,DEFAULTS
對象是默認值,options
對象是用戶提供的參數。Object.assign
方法將DEFAULTS
和options
合並成一個新對象,如果兩者有同名屬性,則option
的屬性值會覆蓋DEFAULTS
的屬性值。
注意,由於存在淺拷貝的問題,DEFAULTS
對象和options
對象的所有屬性的值,最好都是簡單類型,不要指向另一個對象。否則,DEFAULTS
對象的該屬性很可能不起作用。
還有就是需要注意同名屬性替換的問題。
const DEFAULTS = { url: { host: 'example.com', port: 7070 }, }; processContent({ url: {port: 8000} }) // { // url: {port: 8000} // }
上面代碼的原意是將 url.port
改成 8000,url.host
不變。實際結果卻是options.url
覆蓋掉DEFAULTS.url
,所以url.host
就不存在了。