Object.assign()方法用于将所有可枚举的属性的值从一个或多个源对象复制到目标对象。它将返回目标对象。
语法
Object.assign(target, ...sources)
参数
target
目标对象。
sources
(多个)源对象。
返回值
目标对象。
描述
如果目标对象中的属性具有相同的键,则属性将被源中的属性覆盖。后来的源的属性将类似地覆盖早先的属性。
Object.assign方法只会拷贝源对象自身的并且可枚举的属性到目标对象身上。该方法使用源对象的 [ [ Get ] ] 和目标对象的 [ [ Set ] ],所以它会调用相关 getter 和 setter。因此,它分配属性而不是复制或定义新的属性。如果合并源包含了 getter,那么该方法就不适合将新属性合并到原型里。假如是拷贝属性定义到原型里,包括它们的可枚举性,那么应该使用Object.getOwnPropertyDescriptor()和Object.defineProperty()。
注意,在属性拷贝过程中可能会产生异常,比如目标对象的某个只读属性和源对象的某个属性同名,这时该方法会抛出一个TypeError异常,拷贝过程中断,已经拷贝成功的属性不会受到影响,还未拷贝的属性将不会再被拷贝。
注意,Object.assign会跳过那些值为null或undefined的源对象。
示例
复制一个 object
varobj={a:1};varcopy=Object.assign({},obj);console.log(copy);// { a: 1 }
深度拷贝问题
针对深度拷贝,需要使用其他方法,因为Object.assign() 拷贝的是属性值。假如源对象的属性值是一个指向对象的引用,它也只拷贝那个引用值。
functiontest(){leta={b:{c:4},d:{e:{f:1}}}letg=Object.assign({},a)leth=JSON.parse(JSON.stringify(a));console.log(g.d)// { e: { f: 1 } }g.d.e=32console.log('g.d.e set to 32.')// g.d.e set to 32.console.log(g)// { b: { c: 4 }, d: { e: 32 } }console.log(a)// { b: { c: 4 }, d: { e: 32 } }console.log(h)// { b: { c: 4 }, d: { e: { f: 1 } } }h.d.e=54console.log('h.d.e set to 54.')// h.d.e set to 54.console.log(g)// { b: { c: 4 }, d: { e: 32 } }console.log(a)// { b: { c: 4 }, d: { e: 32 } }console.log(h)// { b: { c: 4 }, d: { e: 54 } }}test();
合并 objects
varo1={a:1};varo2={b:2};varo3={c:3};varobj=Object.assign(o1,o2,o3);console.log(obj);// { a: 1, b: 2, c: 3 }console.log(o1);// { a: 1, b: 2, c: 3 }, 注意目标对象自身也会改变。
拷贝 symbol 类型的属性
varo1={a:1};varo2={[Symbol("foo")]:2};varobj=Object.assign({},o1,o2);console.log(obj);// { a: 1, [Symbol("foo")]: 2 }
继承属性和不可枚举属性是不能拷贝的
varobj=Object.create({foo:1},{// foo 是个继承属性。bar:{value:2// bar 是个不可枚举属性。},baz:{value:3,enumerable:true// baz 是个自身可枚举属性。}});varcopy=Object.assign({},obj);console.log(copy);// { baz: 3 }
原始类型会被包装为 object
varv1="abc";varv2=true;varv3=10;varv4=Symbol("foo")varobj=Object.assign({},v1,null,v2,undefined,v3,v4);// 原始类型会被包装,null 和 undefined 会被忽略。// 注意,只有字符串的包装对象才可能有自身可枚举属性。console.log(obj);// { "0": "a", "1": "b", "2": "c" }
异常会打断接下来的拷贝任务
vartarget=Object.defineProperty({},"foo",{value:1,writable:false});// target 的 foo 属性是个只读属性。Object.assign(target,{bar:2},{foo2:3,foo:3,foo3:3},{baz:4});// TypeError: "foo" is read-only// 注意这个异常是在拷贝第二个源对象的第二个属性时发生的。console.log(target.bar);// 2,说明第一个源对象拷贝成功了。console.log(target.foo2);// 3,说明第二个源对象的第一个属性也拷贝成功了。console.log(target.foo);// 1,只读属性不能被覆盖,所以第二个源对象的第二个属性拷贝失败了。console.log(target.foo3);// undefined,异常之后 assign 方法就退出了,第三个属性是不会被拷贝到的。console.log(target.baz);// undefined,第三个源对象更是不会被拷贝到的。
拷贝访问器(accessor)
varobj={foo:1,getbar(){return2;}};varcopy=Object.assign({},obj);// { foo: 1, bar: 2 }// copy.bar的值来自obj.bar的getter函数的返回值console.log(copy);// 下面这个函数会拷贝所有自有属性的属性描述符functioncompleteAssign(target,...sources){sources.forEach(source=>{letdescriptors=Object.keys(source).reduce((descriptors,key)=>{descriptors[key]=Object.getOwnPropertyDescriptor(source,key);returndescriptors;},{});// Object.assign 默认也会拷贝可枚举的SymbolsObject.getOwnPropertySymbols(source).forEach(sym=>{letdescriptor=Object.getOwnPropertyDescriptor(source,sym);if(descriptor.enumerable){descriptors[sym]=descriptor;}});Object.defineProperties(target,descriptors);});returntarget;}varcopy=completeAssign({},obj);// { foo:1, get bar() { return 2 } }console.log(copy);
Polyfill
由于 ES5 里压根就没有 symbol 这种数据类型,所以这个polyfill也没必要去支持 symbol 属性(意思就是说,有 symbol 的环境一定有原生的Object.assign):
if(typeofObject.assign!='function'){Object.assign=function(target){'use strict';if(target==null){thrownewTypeError('Cannot convert undefined or null to object');}target=Object(target);for(varindex=1;index