Object.assign()

Object.assign() 方法用於將全部可枚舉的屬性的值從一個或多個源對象複製到目標對象。它將返回目標對象。

語法

Object.assign(target, ...sources)

 

參數

target

目標對象。

sources

(多個)源對象。

返回值

目標對象。

描述

若是目標對象中的屬性具備相同的鍵，則屬性將被源中的屬性覆蓋。後來的源的屬性將相似地覆蓋早先的屬性。

Object.assign 方法只會拷貝源對象自身的而且可枚舉的屬性到目標對象身上。該方法使用源對象的 [ [ Get ] ] 和目標對象的 [ [ Set ] ]，因此它會調用相關 getter 和 setter。所以，它分配屬性而不是複製或定義新的屬性。若是合併源包含了 getter，那麼該方法就不適合將新屬性合併到原型裏。假如是拷貝屬性定義到原型裏，包括它們的可枚舉性，那麼應該使用 Object.getOwnPropertyDescriptor()和 Object.defineProperty() 。

String類型和 Symbol 類型的屬性都會被拷貝。

注意，在屬性拷貝過程當中可能會產生異常，好比目標對象的某個只讀屬性和源對象的某個屬性同名，這時該方法會拋出一個 TypeError 異常，拷貝過程當中斷，已經拷貝成功的屬性不會受到影響，還未拷貝的屬性將不會再被拷貝。

注意， Object.assign 會跳過那些值爲 null 或 undefined 的源對象。

示例

複製一個 object

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

 

深度拷貝問題

針對深度拷貝，須要使用其餘方法，由於 Object.assign() 拷貝的是屬性值。假如源對象的屬性值是一個指向對象的引用，它也只拷貝那個引用值。

function test() {
  let a = { b: {c:4} , d: { e: {f:1}} }
  let g = Object.assign({},a)
  let h = JSON.parse(JSON.stringify(a));
  console.log(g.d) // { e: { f: 1 } }
  g.d.e = 32
  console.log('g.d.e set to 32.') // g.d.e set to 32.
  console.log(g) // { b: { c: 4 }, d: { e: 32 } }
  console.log(a) // { b: { c: 4 }, d: { e: 32 } }
  console.log(h) // { b: { c: 4 }, d: { e: { f: 1 } } }
  h.d.e = 54
  console.log('h.d.e set to 54.') // h.d.e set to 54.
  console.log(g) // { b: { c: 4 }, d: { e: 32 } }
  console.log(a) // { b: { c: 4 }, d: { e: 32 } }
  console.log(h) // { b: { c: 4 }, d: { e: 54 } }
}
test();

 

合併 objects

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 }, 注意目標對象自身也會改變。

 

拷貝 symbol 類型的屬性

var o1 = { a: 1 };
var o2 = { [Symbol("foo")]: 2 }; var obj = Object.assign({}, o1, o2); console.log(obj); // { a: 1, [Symbol("foo")]: 2 }

 

繼承屬性和不可枚舉屬性是不能拷貝的

var obj = Object.create({foo: 1}, { // foo 是個繼承屬性。
    bar: {
        value: 2  // bar 是個不可枚舉屬性。
 }, baz: { value: 3, enumerable: true // baz 是個自身可枚舉屬性。  } }); var copy = Object.assign({}, obj); console.log(copy); // { baz: 3 }

 

原始類型會被包裝爲 object

var v1 = "abc";
var v2 = true; var v3 = 10; var v4 = Symbol("foo") var obj = Object.assign({}, v1, null, v2, undefined, v3, v4); // 原始類型會被包裝，null 和 undefined 會被忽略。 // 注意，只有字符串的包裝對象纔可能有自身可枚舉屬性。 console.log(obj); // { "0": "a", "1": "b", "2": "c" }

 

異常會打斷接下來的拷貝任務

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，第三個源對象更是不會被拷貝到的。

 

拷貝訪問器（accessor）

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); // { foo:1, get bar() { return 2 } } console.log(copy);

 

Polyfill

因爲 ES5 裏壓根就沒有 symbol 這種數據類型，因此這個 polyfill 也不必去支持 symbol 屬性（意思就是說，有 symbol 的環境必定有原生的 Object.assign）：

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; }; }

 

原文：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/assign