Object.assign()

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

语法

Object.assign(target, ...sources)

参数

  • target 目标对象。
  • sources源对象。

返回值

目标对象。

实际应用

复制一个对象

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

将一个字符串变为类数组对象

原始类型会被包装,null 和 undefined 会被忽略,但只有字符串可以被包装,因为只有字符串的包装对象才有可枚举属性。

let a = 'abc'
let b = Object.assign({}, a);
console.log(b) // Object { 0: "a", 1: "b", 2: "c" }

另一个例子

let v1 = "abc";
let v2 = true;
let v3 = 10;
let v4 = Symbol("foo")
let v5 = 'hello';
let obj = Object.assign({}, v1, null, v2, undefined, v3, v4, v5);
console.log(obj); // Object { 0: "h", 1: "e", 2: "l", 3: "l", 4: "o" }

深拷贝

针对深拷贝,如果对象的属性值是一个指向对象的引用,它也只拷贝那个引用值。

let obj1 = {
  a: 0,
  b: {
    c: {
      d: 0,
      e: [1, 2, 3]
    }
  },
  print (name) {
  	console.log(name)
  }
};
let obj2 = Object.assign({}, obj1);
console.log(obj2);
/*
  Object { a: 0, b: Object { c: Object { d: 0, e: Array [1, 2, 3] } }, print: print(name) {
  	console.log(name)
  } }
*/

合并对象

Object.assign 还可用于对象的合并,如果对象中含有同名键值,后面的将覆盖前面的。

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

上述代码使用 o1 作为容器,所以最终 o1 也发生了改变,如果使用 var obj = Object.assign({}, o1, o2, o3); 就不会出现这种问题。

拷贝 symbol 类型的属性

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

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

Object.assign 方法只会拷贝源对象自身的并且可枚举的属性到目标对象。该方法使用源对象的[[Get]]和目标对象的[[Set]],所以它会调用相关 getter 和 setter。因此,它分配属性,而不仅仅是复制或定义新的属性。如果合并源包含getter,这可能使其不适合将新属性合并到原型中。为了将属性定义(包括其可枚举性)复制到原型,应使用Object.getOwnPropertyDescriptor()Object.defineProperty()

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

异常会打断后续拷贝任务

在出现错误的情况下,例如,如果属性不可写,会引发TypeError,此时将中断拷贝。

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

拷贝访问器

var obj = {
  foo: 1,
  get bar() {
    return 2;
  }
};
var copy = Object.assign({}, obj);
// { foo: 1, bar: 2 }
// copy.bar的值来自obj.bar的getter函数的返回值
console.log(copy);
// 下面这个函数会拷贝所有自有属性的属性描述符
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;
}
var copy = completeAssign({}, obj);
console.log(copy);
// { foo:1, get bar() { return 2 } }

参考资料:

assign

MIT Licensed | Copyright © 2018-present 滇ICP备16006294号

Design by Quanzaiyu | Power by VuePress