Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Object.assign: copiar valores propios

Object.assign copia valores de propiedades propias enumerables desde fuentes a un objeto destino.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

Object.assign(target, ...sources)

Object.assign(target, ...sources) aplica primero ToObject a target: null y undefined lanzan TypeError, mientras que un destino primitivo se envuelve y se devuelve como objeto. Las fuentes se procesan de izquierda a derecha; null y undefined se omiten y las demás primitivas se envuelven. Una fuente posterior puede sobrescribir un valor anterior.

Para cada fuente, el algoritmo toma una instantánea OwnPropertyKeys. Para cada clave comprueba después el descriptor propio actual y, si es enumerable, ejecuta Get en la fuente y Set en el destino con lanzamiento de errores activado. Copia así claves propias enumerables de cadena y símbolo, pero no propiedades heredadas ni no enumerables. Getters, setters y trampas Proxy pueden ejecutarse o lanzar.

Es una copia superficial de valores: no clona descriptores, prototipo ni objetos anidados. La operación no es transaccional: si escribir en un destino de solo lectura o no extensible, o el código de usuario, lanza, las escrituras anteriores permanecen. El método existe desde ECMAScript 2015. Para fuentes no confiables, selecciona claves permitidas en vez de tratar assign como una fusión segura.

Ejemplos

const token = Symbol("token");
const nested = { enabled: true };
const source = { get score() { console.log("get score"); return 7; }, nested };
Object.defineProperty(source, "hidden", { value: 9, enumerable: false });
source[token] = "ok";
const target = { score: 1, label: "base" };
const result = Object.assign(target, { label: "first" }, source);
console.log(result === target, result.label, result.score, result[token], Object.hasOwn(result, "hidden"));
console.log(result.nested === nested);
const partial = {};
const failing = {};
Object.defineProperties(failing, {
  b: { enumerable: true, get() { throw new Error("stop"); } },
  c: { enumerable: true, value: 3 }
});
try { Object.assign(partial, { a: 1 }, failing); } catch (error) {
  console.log(error.message, Object.hasOwn(partial, "a"), Object.hasOwn(partial, "c"));
}

Resultado

get score
true first 7 ok false
true
stop true false

El ejemplo muestra orden de fuentes, getter, Symbol, propiedad no enumerable omitida, referencia compartida y escritura parcial tras un error.

Fuentes