object.assign

varassign=require('object.assign').getPolyfill();// returns native method if compliant/* or */varassign=require('object.assign/polyfill')();// returns native method if compliant

Example

varassert=require('assert');// Multiple sources!vartarget={a:true};varsource1={b:true};varsource2={c:true};varsourceN={n:true};varexpected={a:true,b:true,c:true,n:true};assign(target,source1,source2,sourceN);assert.deepEqual(target,expected);// AWESOME!

vartarget={a:true,b:true,c:true};varsource1={c:false,d:false};varsourceN={e:false};varassigned=assign(target,source1,sourceN);assert.equal(target,assigned);// returns the target objectassert.deepEqual(assigned,{a:true,b:true,c:false,d:false,e:false});

/* when Object.assign is not present */deleteObject.assign;varshimmedAssign=require('object.assign').shim();/* or */varshimmedAssign=require('object.assign/shim')();assert.equal(shimmedAssign,assign);vartarget={a:true,b:true,c:true};varsource={c:false,d:false,e:false};varassigned=assign(target,source);assert.deepEqual(Object.assign(target,source),assign(target,source));

/* when Object.assign is present */varshimmedAssign=require('object.assign').shim();assert.equal(shimmedAssign,Object.assign);vartarget={a:true,b:true,c:true};varsource={c:false,d:false,e:false};assert.deepEqual(Object.assign(target,source),assign(target,source));

Tests