Object.assign()
O método Object.assign()
é usado para copiar os valores de todas as propriedades próprias enumeráveis de um ou mais objetos de origem para um objeto destino. Este método irá retornar o objeto destino.
Experimente
Sintaxe
Object.assign(destino, ...origens)
Parâmetros
Valor retornado
O objeto destino será retornado.
Descrição
O método Object.assign()
copia apenas propriedades enumeráveis e próprias de um objeto de origem para um objeto destino. Ele usa [[Get]]
na origem e [[Put]]
no destino, então isto irá invocar getters e setters.
Portanto, ele atribui propriedades, em vez de simplesmente copiar ou definir novas propriedades. Isso pode fazê-lo impróprio para combinar novas propriedades com um prototype se os objetos de origem contiverem getters. Para copiar definições de propriedades, incluindo sua enumerabilidade, para prototypes Object.getOwnPropertyDescriptor()
e Object.defineProperty()
devem ser utilizadas no lugar.
Ambas as propriedades String
e Symbol
são copiadas.
No caso de erro, por exemplo, se uma propriedade não é writable, um TypeError
será lançado e o objeto destino permanecerá inalterado. Note que Object.assign()
não lança erros caso algum argumento source seja null
ou undefined
.
Exemplos
Clonando um objeto
var obj = { a: 1 };
var copy = Object.assign({}, obj);
console.log(copy); // { a: 1 }
Mesclando objetos
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.
Copiando propriedades Symbol
var o1 = { a: 1 };
var o2 = { [Symbol("foo")]: 2 };
var obj = Object.assign({}, o1, o2);
console.log(obj); // { a: 1, [Symbol("foo")]: 2 }
Propriedades herdadas e não enumeráveis não podem ser copiadas
var obj = Object.create(
{ foo: 1 },
{
// foo is an inherit property.
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 }
Primitivas serão encapsuladas em objetos
var v1 = "123";
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": "1", "1": "2", "2": "3" }
Exceções irão interromper a tarefa de cópia em execução
var target = Object.defineProperty({}, "foo", {
value: 1,
writeable: 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.
Copiando acessores
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 which can copy accessors.
function myAssign(target, ...sources) {
sources.forEach((source) => {
Object.defineProperties(
target,
Object.keys(source).reduce((descriptors, key) => {
descriptors[key] = Object.getOwnPropertyDescriptor(source, key);
return descriptors;
}, {}),
);
});
return target;
}
var copy = myAssign({}, obj);
console.log(copy);
// { foo:1, get bar() { return 2 } }
Polyfill
Este polyfill não suporta propriedades Symbol
, visto que ES5 não possui símbolos:
if (!Object.assign) {
Object.defineProperty(Object, "assign", {
enumerable: false,
configurable: true,
writable: true,
value: function (target) {
"use strict";
if (target === undefined || target === null) {
throw new TypeError("Cannot convert first argument to object");
}
var to = Object(target);
for (var i = 1; i < arguments.length; i++) {
var nextSource = arguments[i];
if (nextSource === undefined || nextSource === null) {
continue;
}
nextSource = Object(nextSource);
var keysArray = Object.keys(Object(nextSource));
for (
var nextIndex = 0, len = keysArray.length;
nextIndex < len;
nextIndex++
) {
var nextKey = keysArray[nextIndex];
var desc = Object.getOwnPropertyDescriptor(nextSource, nextKey);
if (desc !== undefined && desc.enumerable) {
to[nextKey] = nextSource[nextKey];
}
}
}
return to;
},
});
}
Especificações
Specification |
---|
ECMAScript Language Specification # sec-object.assign |
Compatibilidade com navegadores
BCD tables only load in the browser