es6 Object.assign(target, ...sources)

Object.assign() 方法用于将所有可枚举属性(对象属性)的值从一个或多个源对象复制到目标对象。它将返回目标对象。

语法

Object.assign(target, ...sources)

参数

target

目标对象。

sources

源对象。

返回值

目标对象。

const target = { a: 1, b: 2 };
const source = { b: 4, c: 5 };
 
const returnedTarget = Object.assign(target, source);
 
console.log(target);
// expected output: Object { a: 1, b: 4, c: 5 }
 
console.log(returnedTarget);
// expected output: Object { a: 1, b: 4, c: 5 }

结果

》Object { a: 1, b: 4, c: 5 }  源对象也被改变
> Object { a: 1, b: 4, c: 5 } 目标对象也被改变

用来给对象属性赋值  copy对象

实例：

复制一个对象

const obj = { a: 1 };
const copy = Object.assign({}, obj);
console.log(copy); // { a: 1 }

注意:深拷贝问题 链接：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/assign

针对深拷贝，需要使用其他办法，因为 Object.assign()拷贝的是属性值。假如源对象的属性值是一个对象的引用，那么它也只指向那个引用。

let obj1 = { a: 0 , b: { c: 0}};
let obj2 = Object.assign({}, obj1);
console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}} 
obj1.a = 1;
console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}}
console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}} 
obj2.a = 2;
console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}}
console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 0}}
obj2.b.c = 3;
console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 3}}
console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 3}} 
// Deep Clone
obj1 = { a: 0 , b: { c: 0}};
let obj3 = JSON.parse(JSON.stringify(obj1));
obj1.a = 4;
obj1.b.c = 4;
console.log(JSON.stringify(obj3)); // { a: 0, b: { c: 0}}

合并对象节

const o1 = { a: 1 };
const o2 = { b: 2 };
const o3 = { c: 3 };
const obj = Object.assign(o1, o2, o3);
console.log(obj); // { a: 1, b: 2, c: 3 }
console.log(o1);  // { a: 1, b: 2, c: 3 }, 注意目标对象自身也会改变。

合并具有相同属性的对象节

const o1 = { a: 1, b: 1, c: 1 };
const o2 = { b: 2, c: 2 };
const o3 = { c: 3 };
const obj = Object.assign({}, o1, o2, o3);
console.log(obj); // { a: 1, b: 2, c: 3 }

属性被后续参数中具有相同属性的其他对象覆盖。

拷贝 symbol 类型的属性节

const o1 = { a: 1 };
const o2 = { [Symbol('foo')]: 2 };
const obj = Object.assign({}, o1, o2);
console.log(obj); // { a : 1, [Symbol("foo")]: 2 } (cf. bug 1207182 on Firefox)
Object.getOwnPropertySymbols(obj); // [Symbol(foo)]

继承属性和不可枚举属性是不能拷贝的节

const obj = Object.create({foo: 1}, { // foo 是个继承属性。
    bar: {
        value: 2  // bar 是个不可枚举属性。
    },
    baz: {
        value: 3,
        enumerable: true  // baz 是个自身可枚举属性。
    }
});
const copy = Object.assign({}, obj);
console.log(copy); // { baz: 3 }

原始类型会被包装为对象节

const v1 = "abc";
const v2 = true;
const v3 = 10;
const v4 = Symbol("foo")
const obj = Object.assign({}, v1, null, v2, undefined, v3, v4);
// 原始类型会被包装，null 和 undefined 会被忽略。
// 注意，只有字符串的包装对象才可能有自身可枚举属性。
console.log(obj); // { "0": "a", "1": "b", "2": "c" }

异常会打断后续拷贝任务节

const target = 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，第三个源对象更是不会被拷贝到的。

拷贝访问器节

const obj = {
  foo: 1,
  get bar() {
    return 2;
  }
};
let copy = Object.assign({}, obj);
console.log(copy); // { foo: 1, bar: 2 } copy.bar的值来自obj.bar的getter函数的返回值
// 下面这个函数会拷贝所有自有属性的属性描述符
function completeAssign(target, ...sources) {
  sources.forEach(source => {
    let descriptors = Object.keys(source).reduce((descriptors, key) => {
      descriptors[key] = Object.getOwnPropertyDescriptor(source, key);
      return descriptors;
    }, {});
    // Object.assign 默认也会拷贝可枚举的Symbols
    Object.getOwnPropertySymbols(source).forEach(sym => {
      let descriptor = Object.getOwnPropertyDescriptor(source, sym);
      if (descriptor.enumerable) {
        descriptors[sym] = descriptor;
      }
    });
    Object.defineProperties(target, descriptors);
  });
  return target;
}
copy = completeAssign({}, obj);
console.log(copy);
// { foo:1, get bar() { return 2 } }

Polyfill节

此polyfill不支持 symbol 属性，因为ES5 中根本没有 symbol ：

if (typeof Object.assign != 'function') {
  // Must be writable: true, enumerable: false, configurable: true
  Object.defineProperty(Object, "assign", {
    value: function assign(target, varArgs) { // .length of function is 2
      'use strict';
      if (target == null) { // TypeError if undefined or null
        throw new TypeError('Cannot convert undefined or null to object');
      }
      let to = Object(target);
      for (var index = 1; index < arguments.length; index++) {
        var nextSource = arguments[index];
        if (nextSource != null) { // Skip over if undefined or null
          for (let nextKey in nextSource) {
            // Avoid bugs when hasOwnProperty is shadowed
            if (Object.prototype.hasOwnProperty.call(nextSource, nextKey)) {
              to[nextKey] = nextSource[nextKey];
            }
          }
        }
      }
      return to;
    },
    writable: true,
    configurable: true
  });
}

规范节

规范名称	规范状态	备注
ECMAScript 2015 (6th Edition, ECMA-262) Object.assign	Standard	Initial definition.
ECMAScript Latest Draft (ECMA-262) Object.assign	Draft

浏览器兼容节

Update compatibility data on GitHub

	Desktop						Mobile							Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
assign	Full support45	Full support12	Full support34	No supportNo	Full support32	Full support9	No supportNo	Full support45	Full supportYes	Full support34	Full support32	Full supportYes	Full support5.0	Full support4.0.0

Legend

Full support 

Full support

No support 

No support

相关链接节

• Object.defineProperties()
• 属性的可枚举性和所有权

文档标签和贡献者

 标签：

• ECMAScript 2015
• JavaScript
• Method
• Object
• polyfill

 此页面的贡献者： mdnwebdocs-bot, zac_ma, shery, shutong, HJava, Jiang-Xuan, zhangchen, xgqfrms-GitHub, micheal-death, kiyonlin, Wayme, glgjssy, Ende93,Y____C, zhangking, calmcarry, iamchenxin, ziyunfei, rebornix

 最后编辑者: mdnwebdocs-bot, Mar 18, 2019, 4:32:16 PM

1. Web 开发技术
2. JavaScript
3. JavaScript 参考文档
4. JavaScript 标准库
5. Object
6. Object.assign()

相关主题

1. JavaScript 标准库
2. Object
3. 属性
   1. Object.prototype
   2. Object.prototype.__count__
   3. Object.prototype.__noSuchMethod__
   4. Object.prototype.__parent__
   5. Object.prototype.__proto__
   6. Object.prototype.constructor
4. 方法
   1. Object.assign()
   2. Object.create()
   3. Object.defineProperties()
   4. Object.defineProperty()
   5. Object.entries()
   6. Object.freeze()
   7. Object.fromEntries()
   8. Object.getNotifier()
   9. Object.getOwnPropertyDescriptor()
   10. Object.getOwnPropertyDescriptors()
   11. Object.getOwnPropertyNames()
   12. Object.getOwnPropertySymbols()
   13. Object.getPrototypeOf()
   14. Object.is()
   15. Object.isExtensible()
   16. Object.isFrozen()
   17. Object.isSealed()
   18. Object.keys()
   19. Object.observe()
   20. Object.preventExtensions()
   21. Object.prototype.__defineGetter__()
   22. Object.prototype.__defineSetter__()
   23. Object.prototype.__lookupGetter__()
   24. Object.prototype.__lookupSetter__()
   25. Object.prototype.eval()
   26. Object.prototype.hasOwnProperty()
   27. Object.prototype.isPrototypeOf()
   28. Object.prototype.propertyIsEnumerable()
   29. Object.prototype.toLocaleString()
   30. Object.prototype.toSource()
   31. Object.prototype.toString()
   32. Object.prototype.unwatch()
   33. Object.prototype.valueOf()
   34. Object.prototype.watch()
   35. Object.seal()
   36. Object.setPrototypeOf()
   37. Object.unobserve()
   38. Object.values()
5. 继承
6. Function
7. 属性
   1. Function.arguments
   2. Function.arity
   3. Function.caller
   4. Function.displayName
   5. Function.length
   6. Function.prototype