作用

Object.assign() 方法用于把一个或多个源对象的可枚举属性值复制到目标对象中,返回值为目标对象。

语法

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

参数

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

返回值

目标对象

描述

Object.assign 方法只复制源对象中可枚举的属性和对象自身的属性。它在源对象上使用 [[Get]], 在目标对象上使用 [[Set]], 会调用 getter 和 setter。它不适合用于把一个包含 getter 的对象属性合并到一个原型中。如果要把属性定义连同可枚举性复制到一个原型中,应该使用 Object.getOwnPropertyDescriptor() 和 Object.defineProperty() 方法。

String 和 Symbol 类型的属性都会被复制。

当发生错误时,例如有一个属性是不可写的,将会抛出一个 TypeError 错误,目标对象保持不变。

注意 Object.assign() 源对象为 null 或 undefined 时不会报错。

示例

克隆对象

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

合并对象

1
2
3
4
5
6
7
var o1 = {a: 1};
var o2 = {b: 2};
var o3 = {c: 3};
var obj = Object.assign(o1, o2, o3);
console.log(obj); //{a: 1, b: 2, c: 3}
console.log(o1); //{a: 1, b: 2, c: 3}, //目标对象被改变了

原型链上的属性和不可枚举的属性无法复制

1
2
3
4
5
6
7
8
9
10
11
12
var obj = Object.create({foo: 1}, { // foo 在 obj 的原型链上
bar: {
value: 2 // bar 是一个不可枚举的属性.
},
baz: {
value: 3,
enumerable: true // baz 是 obj 自身的一个可枚举属性
}
});
var copy = Object.assign({}, obj);
console.log(copy); // { baz: 3 },原型链上的属性和不可枚举的属性没有复制到

传递原始类型

1
2
3
4
5
6
7
8
var v1 = 'abc';
var v2 = true;
var v3 = 10;
var v4 = Symbol('foo');
var obj = Object.assign({}, v1, null, v2, undefined, v3, v4);
//注意只有字符串类型的值有可枚举属性
console.log(obj); // { "0": "a", "1": "b", "2": "c" }

异常会中断正在执行的复制任务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
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
// 在分配 target.foo 时该异常被抛出
console.log(target.bar); // 2, 第一个源对象复制成功
console.log(target.foo2); // 3, 第二个源对象的第一个属性复制成功
console.log(target.foo); // 1, 异常在这里抛出
console.log(target.foo3); // undefined, 任务已经结束, foo3 不会被复制 assign
console.log(target.baz); // undefined, 第三个源对象也不会被复制

有访问器的情况

1
2
3
4
5
6
7
8
9
10
var obj = {
foo: 1,
get bar() {
return 2;
}
};
var copy = Object.assign({}, obj);
console.log(copy);
// { foo: 1, bar: 2 }, copy.bar 的值是 bar 的 getter 的返回值

ES5版本实现方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
if (typeof Object.assign != 'function') {
Object.assign = function(target) {
'use strict';
if (target == null) {
throw new TypeError('Cannot convert undefined or null to object');
}
target = Object(target);
for (var index = 1; index < arguments.length; index++) {
var source = arguments[index];
if (source != null) {
for (var key in source) {
if (Object.prototype.hasOwnProperty.call(source, key)) {
target[key] = source[key];
}
}
}
}
return target;
};
}