es6 javascript对象方法Object.assign()

1  基本用法

Object.assign方法用于对象的合并，将源对象（ source ）的所有可枚举属性，复制到目标对象（ target ）。

[javascript] view plain copy

1. var target = { a: 1 };  
2. var source1 = { b: 2 };  
3. var source2 = { c: 3 };  
4. Object.assign(target, source1, source2);  
5. target // {a:1, b:2, c:3}  

Object.assign方法的第一个参数是目标对象，后面的参数都是源对象。

注意，如果目标对象与源对象有同名属性，或多个源对象有同名属性，则后面的属性会覆盖前面的属性。

[javascript] view plain copy

1. var target = { a: 1, b: 1 };  
2. var source1 = { b: 2, c: 2 };  
3. var source2 = { c: 3 };  
4. Object.assign(target, source1, source2);  
5. target // {a:1, b:2, c:3}  

如果只有一个参数，Object.assign会直接返回该参数。

[javascript] view plain copy

1. var obj = {a: 1};  
2. Object.assign(obj) === obj // true  

如果该参数不是对象，则会先转成对象，然后返回。

[javascript] view plain copy

1. typeof Object.assign(2) // "object"  

由于undefined和null无法转成对象，所以如果它们作为参数，就会报错。

[javascript] view plain copy

1. Object.assign(undefined) //  报错  
2. Object.assign(null) //  报错  

如果非对象参数出现在源对象的位置（即非首参数），那么处理规则有所不同。首先，这些参数都会转成对象，如果无法转成对象，就会跳过。这意味着，如果undefined和null不在首参数，就不会报错。

[javascript] view plain copy

1. let obj = {a: 1};  
2. Object.assign(obj, undefined) === obj // true  
3. Object.assign(obj, null) === obj // true  

其他类型的值（即数值、字符串和布尔值）不在首参数，也不会报错。但是，除了字符串会以数组形式，拷贝入目标对象，其他值都不会产生效果。

[javascript] view plain copy

1. var v1 = 'abc';  
2. var v2 = true;  
3. var v3 = 10;  
4. var obj = Object.assign({}, v1, v2, v3);  
5. console.log(obj); // { "0": "a", "1": "b", "2": "c" }  

上面代码中，v1、v2、v3分别是字符串、布尔值和数值，结果只有字符串合入目标对象（以字符数组的形式），数值和布尔值都会被忽略。这是因为只有字符串的包装对象，会产生可枚举属性。

[javascript] view plain copy

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）。

[javascript] view plain copy

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拷贝。

[javascript] view plain copy

1. Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' })  
2. // { a: 'b', Symbol(c): 'd' }  

2  注意点

Object.assign方法实行的是浅拷贝，而不是深拷贝。也就是说，如果源对象某个属性的值是对象，那么目标对象拷贝得到的是这个对象的引用。

[javascript] view plain copy

1. var obj1 = {a: {b: 1}};  
2. var obj2 = Object.assign({}, obj1);  
3. obj1.a.b = 2;  
4. obj2.a.b // 2  

上面代码中，源对象obj1的a属性的值是一个对象，Object.assign拷贝得到的是这个对象的引用。这个对象的任何变化，都会反映到目标对象上面。

对于这种嵌套的对象，一旦遇到同名属性，Object.assign的处理方法是替换，而不是添加。

[javascript] view plain copy

1. var target = { a: { b: 'c', d: 'e' } }  
2. var 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可以用来处理数组，但是会把数组视为对象。

[javascript] view plain copy

1. Object.assign([1, 2, 3], [4, 5])  
2. // [4, 5, 3]  

上面代码中，Object.assign把数组视为属性名为 0 、 1 、 2 的对象，因此目标数组的 0 号属性4覆盖了原数组的 0 号属性1。

3  常见用途

（ 1 ）为对象添加属性

[javascript] view plain copy

1. class Point {  
2.     constructor(x, y) {  
3.         Object.assign(this, {x, y});  
4.     }  
5. }  

上面方法通过Object.assign方法，将x属性和y属性添加到Point类的对象实例。

（ 2 ）为对象添加方法

[javascript] view plain copy

1. Object.assign(SomeClass.prototype, {  
2.     someMethod(arg1, arg2) {  
3.     ···  
4.     },  
5.     anotherMethod() {  
6.     ···  
7.     }  
8. });  
9. //  等同于下面的写法  
10. SomeClass.prototype.someMethod = function (arg1, arg2) {  
11. ···  
12. };  
13. SomeClass.prototype.anotherMethod = function () {  
14. ···  
15. };  

上面代码使用了对象属性的简洁表示法，直接将两个函数放在大括号中，再使用 assign 方法添加到 SomeClass.prototype 之中。

（ 3 ）克隆对象

[javascript] view plain copy

1. function clone(origin) {  
2.     return Object.assign({}, origin);  
3. }  

上面代码将原始对象拷贝到一个空对象，就得到了原始对象的克隆。
不过，采用这种方法克隆，只能克隆原始对象自身的值，不能克隆它继承的值。如果想要保持继承链，可以采用下面的代码。

[javascript] view plain copy

1. function clone(origin) {  
2.     let originProto = Object.getPrototypeOf(origin);  
3.     return Object.assign(Object.create(originProto), origin);  
4. }  

（ 4 ）合并多个对象

将多个对象合并到某个对象。

[javascript] view plain copy

1. const merge =(target, ...sources) => Object.assign(target, ...sources);  

如果希望合并后返回一个新对象，可以改写上面函数，对一个空对象合并。

[javascript] view plain copy

1. const merge =(...sources) => Object.assign({}, ...sources);  

（ 5 ）为属性指定默认值

[javascript] view plain copy

1. const DEFAULTS = {  
2.     logLevel: 0,  
3.     outputFormat: 'html'  
4. };  
5. function processContent(options) {  
6.     let options = Object.assign({}, DEFAULTS, options);  
7. }  

上面代码中，DEFAULTS对象是默认值，options对象是用户提供的参数。Object.assign方法将DEFAULTS和options合并成一个新对象，如果两者有同名属性，则option的属性值会覆盖DEFAULTS的属性值。
注意，由于存在深拷贝的问题，DEFAULTS对象和options对象的所有属性的值，都只能是简单类型，而不能指向另一个对象。否则，将导致DEFAULTS对象的该属性不起作用。