1  基本用法

Object.assign方法用於物件的合併，將源物件（ source ）的所有可列舉屬性，複製到目標物件（ target ）。

var target = { a: 1 };
var source1 = { b: 2 };
var source2 = { c: 3 };
Object.assign(target, source1, source2);
target // {a:1, b:2, c:3}

Object.assign方法的第一個引數是目標物件，後面的引數都是源物件。

注意，如果目標物件與源物件有同名屬性，或多個源物件有同名屬性，則後面的屬性會覆蓋前面的屬性。

var target = { a: 1, b: 1 };
var source1 = { b: 2, c: 2 };
var source2 = { c: 3 };
Object.assign(target, source1, source2);
target // {a:1, b:2, c:3}
 

如果只有一個引數，Object.assign會直接返回該引數。

var obj = {a: 1};
Object.assign(obj) === obj // true

如果該引數不是物件，則會先轉成物件，然後返回。

typeof Object.assign(2) // "object"

由於undefined和null無法轉成物件，所以如果它們作為引數，就會報錯。

Object.assign(undefined) //  報錯
Object.assign(null) //  報錯

如果非物件引數出現在源物件的位置（即非首引數），那麼處理規則有所不同。首先，這些引數都會轉成物件，如果無法轉成物件，就會跳過。這意味著，如果undefined和null不在首引數，就不會報錯。

let obj = {a: 1};
Object.assign(obj, undefined) === obj // true
Object.assign(obj, null) === obj // true
 

其他型別的值（即數值、字串和布林值）不在首引數，也不會報錯。但是，除了字串會以陣列形式，拷貝入目標物件，其他值都不會產生效果。

var v1 = 'abc';
var v2 = true;
var v3 = 10;
var obj = Object.assign({}, v1, v2, v3);
console.log(obj); // { "0": "a", "1": "b", "2": "c" }

上面程式碼中，v1、v2、v3分別是字串、布林值和數值，結果只有字串合入目標物件（以字元陣列的形式），數值和布林值都會被忽略。這是因為只有字串的包裝物件，會產生可列舉屬性。

Object(true) // {[[PrimitiveValue]]: true}
Object(10) // {[[PrimitiveValue]]: 10}
Object('abc') // {0: "a", 1: "b", 2: "c", length: 3, [[PrimitiveValue]]: "abc"}
 

上面程式碼中，布林值、數值、字串分別轉成對應的包裝物件，可以看到它們的原始值都在包裝物件的內部屬性[[PrimitiveValue]]上面，這個屬性是不會被Object.assign拷貝的。只有字串的包裝物件，會產生可列舉的實義屬性，那些屬性則會被拷貝。

Object.assign拷貝的屬性是有限制的，只拷貝源物件的自身屬性（不拷貝繼承屬性），也不拷貝不可列舉的屬性（enumerable: false）。

Object.assign({b: 'c'},
	Object.defineProperty({}, 'invisible', {
		enumerable: false,
		value: 'hello'
	})
)
// { b: 'c' }

上面程式碼中，Object.assign要拷貝的物件只有一個不可列舉屬性invisible，這個屬性並沒有被拷貝進去。
屬性名為 Symbol 值的屬性，也會被Object.assign拷貝。

Object.assign({ a: 'b' }, { [Symbol('c')]: 'd' })
// { a: 'b', Symbol(c): 'd' }

2  注意點

Object.assign方法實行的是淺拷貝，而不是深拷貝。也就是說，如果源物件某個屬性的值是物件，那麼目標物件拷貝得到的是這個物件的引用。

var obj1 = {a: {b: 1}};
var obj2 = Object.assign({}, obj1);
obj1.a.b = 2;
obj2.a.b // 2

上面程式碼中，源物件obj1的a屬性的值是一個物件，Object.assign拷貝得到的是這個物件的引用。這個物件的任何變化，都會反映到目標物件上面。

對於這種巢狀的物件，一旦遇到同名屬性，Object.assign的處理方法是替換，而不是新增。

var target = { a: { b: 'c', d: 'e' } }
var source = { a: { b: 'hello' } }
Object.assign(target, source)
// { a: { b: 'hello' } }

上面程式碼中，target物件的a屬性被source物件的a屬性整個替換掉了，而不會得到{ a: { b: 'hello', d: 'e' } }的結果。這通常不是開發者想要的，需要特別小心。
有一些函式庫提供Object.assign的定製版本（比如 Lodash 的_.defaultsDeep方法），可以解決淺拷貝的問題，得到深拷貝的合併。
注意，Object.assign可以用來處理陣列，但是會把陣列視為物件。

Object.assign([1, 2, 3], [4, 5])
// [4, 5, 3]

上面程式碼中，Object.assign把陣列視為屬性名為 0 、 1 、 2 的物件，因此目標陣列的 0 號屬性4覆蓋了原陣列的 0 號屬性1。

3  常見用途

（ 1 ）為物件新增屬性

class Point {
	constructor(x, y) {
		Object.assign(this, {x, y});
	}
}

上面方法通過Object.assign方法，將x屬性和y屬性新增到Point類的物件例項。

（ 2 ）為物件新增方法

Object.assign(SomeClass.prototype, {
	someMethod(arg1, arg2) {
	···
	},
	anotherMethod() {
	···
	}
});
//  等同於下面的寫法
SomeClass.prototype.someMethod = function (arg1, arg2) {
···
};
SomeClass.prototype.anotherMethod = function () {
···
};

上面程式碼使用了物件屬性的簡潔表示法，直接將兩個函式放在大括號中，再使用 assign 方法新增到 SomeClass.prototype 之中。

（ 3 ）克隆物件

function clone(origin) {
	return Object.assign({}, origin);
}

上面程式碼將原始物件拷貝到一個空物件，就得到了原始物件的克隆。
不過，採用這種方法克隆，只能克隆原始物件自身的值，不能克隆它繼承的值。如果想要保持繼承鏈，可以採用下面的程式碼。

function clone(origin) {
	let originProto = Object.getPrototypeOf(origin);
	return Object.assign(Object.create(originProto), origin);
}

（ 4 ）合併多個物件

將多個物件合併到某個物件。

const merge =(target, ...sources) => Object.assign(target, ...sources);

如果希望合併後返回一個新物件，可以改寫上面函式，對一個空物件合併。

const merge =(...sources) => Object.assign({}, ...sources);

（ 5 ）為屬性指定預設值

const DEFAULTS = {
	logLevel: 0,
	outputFormat: 'html'
};
function processContent(options) {
	let options = Object.assign({}, DEFAULTS, options);
}

上面程式碼中，DEFAULTS物件是預設值，options物件是使用者提供的引數。Object.assign方法將DEFAULTS和options合併成一個新物件，如果兩者有同名屬性，則option的屬性值會覆蓋DEFAULTS的屬性值。
注意，由於存在深拷貝的問題，DEFAULTS物件和options物件的所有屬性的值，都只能是簡單型別，而不能指向另一個物件。否則，將導致DEFAULTS物件的該屬性不起作用。