null tor 添加 -m property pan 希望 asc ...

1 基本用法

Object.assign方法用於對象的合並，將源對象（ source ）的所有可枚舉屬性，復制到目標對象（ target ）。

[javascript] view plain copy

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

Object.assign方法的第一個參數是目標對象，後面的參數都是源對象。

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

[javascript] view plain copy

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

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

[javascript] view plain copy

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

如果該參數不是對象，則會先轉成對象，然後返回。

[javascript] view plain copy

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

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

[javascript] view plain copy

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

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

[javascript] view plain copy

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

其他類型的值（即數值、字符串和布爾值）不在首參數，也不會報錯。但是，除了字符串會以數組形式，拷貝入目標對象，其他值都不會產生效果。

[javascript] view plain copy

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

上面代碼中，v1、v2、v3分別是字符串、布爾值和數值，結果只有字符串合入目標對象（以字符數組的形式），數值和布爾值都會被忽略。這是因為只有字符串的包裝對象，會產生可枚舉屬性。

[javascript] view plain copy

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

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

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

[javascript] view plain copy

1. Object.assign({b: ‘c‘},
2. Object.defineProperty({}, ‘invisible‘, {
3. enumerable: false,
4. value: ‘hello‘
5. })
6. )
7. // { b: ‘c‘ }

上面代碼中，Object.assign要拷貝的對象只有一個不可枚舉屬性invisible，這個屬性並沒有被拷貝進去。
屬性名為 Symbol 值的屬性，也會被Object.assign拷貝。

[javascript] view plain copy

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

2 註意點

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

[javascript] view plain copy

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

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

對於這種嵌套的對象，一旦遇到同名屬性，Object.assign的處理方法是替換，而不是添加。

[javascript] view plain copy

1. var target = { a: { b: ‘c‘, d: ‘e‘ } }
2. var source = { a: { b: ‘hello‘ } }
3. Object.assign(target, source)
4. // { a: { b: ‘hello‘ } }

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

[javascript] view plain copy

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

上面代碼中，Object.assign把數組視為屬性名為 0 、 1 、 2 的對象，因此目標數組的 0 號屬性4覆蓋了原數組的 0 號屬性1。

3 常見用途

（ 1 ）為對象添加屬性

[javascript] view plain copy

1. class Point {
2. constructor(x, y) {
3. Object.assign(this, {x, y});
4. }
5. }

上面方法通過Object.assign方法，將x屬性和y屬性添加到Point類的對象實例。

（ 2 ）為對象添加方法

[javascript] view plain copy

1. Object.assign(SomeClass.prototype, {
2. someMethod(arg1, arg2) {
3. ···
4. },
5. anotherMethod() {
6. ···
7. }
8. });
9. // 等同於下面的寫法
10. SomeClass.prototype.someMethod = function (arg1, arg2) {
11. ···
12. };
13. SomeClass.prototype.anotherMethod = function () {
14. ···
15. };

上面代碼使用了對象屬性的簡潔表示法，直接將兩個函數放在大括號中，再使用 assign 方法添加到 SomeClass.prototype 之中。

（ 3 ）克隆對象

[javascript] view plain copy

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

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

[javascript] view plain copy

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

（ 4 ）合並多個對象

將多個對象合並到某個對象。

[javascript] view plain copy

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

如果希望合並後返回一個新對象，可以改寫上面函數，對一個空對象合並。

[javascript] view plain copy

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

（ 5 ）為屬性指定默認值

[javascript] view plain copy

1. const DEFAULTS = {
2. logLevel: 0,
3. outputFormat: ‘html‘
4. };
5. function processContent(options) {
6. let options = Object.assign({}, DEFAULTS, options);
7. }

上面代碼中，DEFAULTS對象是默認值，options對象是用戶提供的參數。Object.assign方法將DEFAULTS和options合並成一個新對象，如果兩者有同名屬性，則option的屬性值會覆蓋DEFAULTS的屬性值。
註意，由於存在深拷貝的問題，DEFAULTS對象和options對象的所有屬性的值，都只能是簡單類型，而不能指向另一個對象。否則，將導致DEFAULTS對象的該屬性不起作用。

ES6對象方法Object.assign()