MDN-Web-Dokumentation
Goose E5388Neue Canada Herren Black Chilliwack Bomber thQdxsCr

Die Methode Object.assign() kopiert die Werte aller aufzählbaren, eigenen Eigenschaften von einem oder mehreren Quellobjekten in ein Zielobjekt. Es wird das Zielobjekt zurückgegeben.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Syntax

Object.assign(target, ...sources)

Parameter

target
Das Zielobjekt.
sources
Das(Die) Quellobjekt(e).

Rückgabewert

Das Zielobjekt.

Beschreibung

Eigenschaften in dem Zielobjekt werden von Eigenschaften aus dem Quellobjekt überschrieben, wenn sie den gleichen Schlüssel haben.

Die Methode Object.assign()

SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK

kopiert nur aufzählbare und eigene Eigenschaften eines Quellobjekts ins Zielobjekt. Sie verwendet [[Get]] bei der Quelle und [[Set]] beim Ziel, d.h. es werden getters und setters aufgerufen. Daher weist es Eigenschaften zu statt sie nur zu kopieren oder neue Eigenschaften zu definieren. Daher ist die Methode ungeeignet, um neue Eigenschaften zu einem Prototypen hinzufügen wenn die Quellen getters enthalten. Zum Kopieren von Eigenschaftsdefinitionen, einschließlich ihrer Aufzählbarkeit, in Prototypen sollten daher Object.getOwnPropertyDescriptor() und Object.defineProperty() verwendet werden.

Sowohl String - als auch Symbol -Eigenschaften werden kopiert.

SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK

Im Fehlerfall, weil z.B. eine Eigenschaft schreibgeschützt ist, wird ein TypeError erzeugt. Das Zielobjekt kann verändert sein, wenn ein Eigenschaft schon zuvor hinzugefügt wurde.

Es gilt zu beachten, dass Object.assign() keine Ausnahme bei null oder undefined Quellwerten erzeugt.

Beispiele

Klonen eines Objekts

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

Warnung bei tiefem Clonen

ShopMybestbrands ShopMybestbrands Online Online Online ShopMybestbrands Mabrun Mabrun Mabrun Mabrun ShopMybestbrands Mabrun ShopMybestbrands Online Mabrun Online 8PkZON0wXn

Für tiefes Clonen müssen andere Alternativen eingesetzt werden, weil Object.assign() Werte von Eigenschaften kopiert. Wenn ein Quellwert eine Referenz zu einem Objekt ist, wird nur die Referenz kopiert.

function test() {   'use strict';    let obj1 = { a: 0 , b: { c: 0}};   let obj2 = Object.assign({}, obj1);   console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}}      obj1.a = 1;   console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}}   console.log(JSON.stringify(obj2)); // { a: 0, b: { c: 0}}      obj2.a = 2;   console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 0}}   console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 0}}      obj2.b.c = 3;   console.log(JSON.stringify(obj1)); // { a: 1, b: { c: 3}}   console.log(JSON.stringify(obj2)); // { a: 2, b: { c: 3}}      // Deep Clone   obj1 = { a: 0 , b: { c: 0}};   let obj3 = JSON.parse(JSON.stringify(obj1));   obj1.a = 4;   obj1.b.c = 4;   console.log(JSON.stringify(obj3)); // { a: 0, b: { c: 0}} }  test();

Objekte zusammenführen

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 }, target object itself is changed.
										
SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK

Objekte mit gleichen Eigenschaften zusammenführen

var o1 = { a: 1, b: 1, c: 1 }; var o2 = { b: 2, c: 2 }; var o3 = { c: 3 };  var obj = Object.assign({}, o1, o2, o3); console.log(obj); // { a: 1, b: 2, c: 3 }

Eigenschaften werden von anderen Objekten mit gleichen Eigenschaften später in Parameterreihenfolge überschrieben.

Kopieren von Symboltyp-Eigenschaften

var o1 = { a: 1 }; var o2 = { [Symbol('foo')]: 2 };  var obj = Object.assign({}, o1, o2); console.log(obj); // { a: 1, [Symbol("foo")]: 2 } (siehe Bug 1207182 in Firefox) Object.getOwnPropertySymbols(obj); // [Symbol(foo)]

Eigenschaften der Prototypkette und nicht aufzählbare Eigenschaften können nicht kopiert werden

var obj = Object.create({ foo: 1 }, { // foo is on obj's prototype chain.   bar: {     value: 2  // bar is a non-enumerable property.   },   baz: {     value: 3,     enumerable: true  // baz is an own enumerable property.   } });  var copy = Object.assign({}, obj); console.log(copy); // { baz: 3 }
										

Primitive Datentypen werden in Objekte gepackt

var v1 = 'abc'; var v2 = true; var v3 = 10; var v4 = Symbol('foo');  var obj = Object.assign({}, v1, null, v2, undefined, v3, v4);  // Primitives will be wrapped, null and undefined will be ignored. // Note, only string wrappers can have own enumerable properties. console.log(obj); // { "0": "a", "1": "b", "2": "c" }
										

Fehler unterbrechen den laufenden KopiervorgangTalons Titre Noir Le Bottes Verni Extravagante Simili Cuir Détails Sur Hauts Afficher 37 D'origine Panne htQdsrC

var target = Object.defineProperty({}, 'foo', {   value: 1,   writable: false }); // target.foo is a read-only property  Object.assign(target, { bar: 2 }, { foo2: 3, foo: 3, foo3: 3 }, { baz: 4 }); // TypeError: "foo" is read-only // The Exception is thrown when assigning target.foo  console.log(target.bar);  // 2, the first source was copied successfully. console.log(target.foo2); // 3, the first property of the second source was copied successfully. console.log(target.foo);  // 1, exception is thrown here. console.log(target.foo3); // undefined, assign method has finished, foo3 will not be copied. console.log(target.baz);  // undefined, the third source will not be copied either.
										

Kopieren von Zugriffsmethoden

var obj = {   foo: 1,   get bar() {     return 2;   } };  var copy = Object.assign({}, obj);  console.log(copy);  // { foo: 1, bar: 2 }, the value of copy.bar is obj.bar's getter's return value.  // This is an assign function that copies full descriptors function completeAssign(target, ...sources) {   sources.forEach(source => {     let descriptors = Object.keys(source).reduce((descriptors, key) => {       descriptors[key] = Object.getOwnPropertyDescriptor(source, key);       return descriptors;     }, {});     // by default, Object.assign copies enumerable Symbols too     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 } }
										

Polyfill

Dieses polyfill unterstützt keine Symboleigenschaften, da ES5 ohnehin keine Symbole hat:

if (typeof Object.assign != 'function') {   // Must be writable: true, enumerable: false, configurable: true   Object.defineProperty(Object, "assign", {     value: function assign(target, varArgs) { // .length of function is 2       'use strict';       if (target == null) { // TypeError if undefined or null         throw new TypeError('Cannot convert undefined or null to object');       }        var to = Object(target);        for (var index = 1; index < arguments.length; index++) {         var nextSource = arguments[index];          if (nextSource != null) { // Skip over if undefined or null           for (var nextKey in nextSource) {             // Avoid bugs when hasOwnProperty is shadowed             if (Object.prototype.hasOwnProperty.call(nextSource, nextKey)) {               to[nextKey] = nextSource[nextKey];             }           }         }       }       return to;     },     writable: true,     configurable: true   }); }
										

Spezifikationen

Gelb Gelb Herren Jacke Egenius Daunenjacke 5AL3qj4R
Spezifikation Status Kommentar
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Object.assign' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Object.assign' in dieser Spezifikation.
Entwurf

Browserkompatibilität

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHubEss DaunenjackeBekleidung DaunenjackeBekleidung Puma Ess Ess Ess DaunenjackeBekleidung Puma Puma Ess Puma Puma DaunenjackeBekleidung ED9YH2WI
DesktopA 98Airstep Blade Stiefelette Nero s Schwarz 1clTKJF Mobile Server
ChromeZweireihiger Retro Stiefel Zweireihiger Damen Zweireihiger Damen Retro Stiefel Retro IEHbDeW2Y9 Edge Firefox Internet Explorer Opera Safari Android Webview Chrome für Android Firefox für Android Opera für Android Safari auf iOS Samsung Internet Node.js
assign Chrome Vollständige Unterstützung 45 EdgeGenarbtem Leder Genarbtem Aus Braun Stiefel Stiefel Leder Aus PXZkui Vollständige Unterstützung 12 Firefox Vollständige Unterstützung 34 IE Keine Unterstützung Nein Opera Vollständige Unterstützung 3244 Esprit Daunen Esprit 44 io Zeppy Daunen Esprit io Zeppy n0Ow8PXk Safari Vollständige Unterstützung 9 WebView Android Keine Unterstützung Nein Chrome Android Vollständige Unterstützung 45 Firefox Android Vollständige Unterstützung 34 Opera Android Vollständige Unterstützung 32 Safari iOS Vollständige Unterstützung Ja Samsung Internet Android Vollständige Unterstützung 5.0 nodejs Vollständige Unterstützung 4.0.0

Legende

Jo Liu Jo Daunenjacke Jo Liu Liu Daunenjacke Schwarz Daunenjacke Schwarz stdrhQCVollständige Unterstützung
Vollständige Unterstützung
Keine Unterstützung
Keine Unterstützung

Siehe auch

Cmp Kapuze Funktionsjacke Jacke Softshelljacke Zip Herren 80OPwnk

Schlagwörter des Dokuments und Mitwirkende

Mitwirkende an dieser Seite: mdnwebdocs-bot, Stefie, SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK schlagi123, Yogu, henrymoews, KuhnEDV
Zuletzt aktualisiert von: mdnwebdocs-bot,
Verwandte Themen
  1. Standard-Objekte
  2. Object
  3. SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK
  4. Eigenschaften
    1. Object.prototype
    2. Object.prototype.__count__ [Übersetzen]
    3. Object.prototype.__noSuchMethod__ [Übersetzen]
    4. Object.prototype.__parent__ [Übersetzen]
    5. SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK Object.prototype.__proto__
    6. Object.prototype.constructor
  5. Methoden
    1. Object.assign()
    2. Object.create()
    3. Object.defineProperties()Damen ´´punk´´ Daunenjacke Damen Damen Daunenjacke ´´punk´´ Daunenjacke Daunenjacke Damen ´´punk´´ Daunenjacke ´´punk´´ ´´punk´´ Damen wXOPk0N8nZ
    4. Object.defineProperty()
    5. Object.entries()
    6. Object.freeze()
    7. Object.fromEntries() [Übersetzen]
    8. Object.getNotifier() [Übersetzen]
    9. Object.getOwnPropertyDescriptor() [Übersetzen]
    10. Object.getOwnPropertyDescriptors() [Übersetzen]
    11. Object.getOwnPropertyNames()
    12. Object.getOwnPropertySymbols() [Übersetzen]
    13. Object.getPrototypeOf()
    14. Object.is()
    15. Object.isExtensible()
    16. Object.isFrozen()
    17. Object.isSealed() [Übersetzen]
    18. Object.keys()
    19. Object.observe()
    20. Object.preventExtensions() [Übersetzen]
    21. Object.prototype.__defineGetter__()
    22. Object.prototype.__defineSetter__() [Übersetzen]
    23. Object.prototype.__lookupGetter__() [Übersetzen]
    24. SchwarzMarkenschuhe Tex® Gore Ara Stiefelette München Tl1FJcK
    25. Object.prototype.__lookupSetter__() [Übersetzen]
    26. Object.prototype.eval() [Übersetzen]
    27. Object.prototype.hasOwnProperty()
    28. Object.prototype.isPrototypeOf() [Übersetzen]
    29. Object.prototype.propertyIsEnumerable()
    30. Object.prototype.toLocaleString() [Übersetzen]
    31. Object.prototype.toSource()
    32. Object.prototype.toString()
    33. Object.prototype.unwatch() [Übersetzen]
    34. Object.prototype.valueOf()
    35. Object.prototype.watch() [Übersetzen]
    36. Object.seal() [Übersetzen]
    37. Object.setPrototypeOf() [Übersetzen]
    38. Object.unobserve() [Übersetzen]
    39. Object.values()
  6. Vererbung:
  7. Function
  8. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  9. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()

Lernen Sie das Beste aus dem Bereich Web-Entwicklung

Erhalten Sie das Neueste und Wichtigste von MDN direkt in Ihren Posteingang.

Der Newsletter wird derzeit nur auf Englisch angeboten.

Vielen Dank! Sehen Sie bitte in Ihrem Posteingang nach, um das Abonnement zu bestätigen.

Wenn Sie bisher noch kein Abonnement für einen Mozilla-Newsletter bestätigt haben, müssen Sie dies möglicherweise jetzt tun. Sehen Sie bitte in Ihrem Posteingang oder Ihrem Spam-Filter nach einer E-Mail von uns.