Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Object.assign: copiar valores próprios

Object.assign copia valores de propriedades próprias enumeráveis das fontes para um objeto de destino.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Object.assign(target, ...sources)

Object.assign(target, ...sources) aplica primeiro ToObject a target: null e undefined lançam TypeError, enquanto um destino primitivo é encapsulado e devolvido como objeto. As fontes são processadas da esquerda para a direita; null e undefined são ignorados e as restantes primitivas são encapsuladas. Uma fonte posterior pode substituir um valor anterior.

Para cada fonte, o algoritmo obtém uma captura OwnPropertyKeys. Para cada chave verifica depois o descritor próprio atual e, se for enumerável, executa Get na fonte e Set no destino com lançamento de erros ativo. Copia assim chaves próprias enumeráveis de texto e símbolo, mas não propriedades herdadas nem não enumeráveis. Getters, setters e traps de Proxy podem executar ou lançar.

É uma cópia superficial de valores: não clona descritores, protótipo nem objetos aninhados. A operação não é transacional — se a escrita num destino só de leitura ou não extensível, ou código do utilizador, lançar, as escritas anteriores permanecem. O método existe desde ECMAScript 2015. Para fontes não fiáveis, seleciona chaves permitidas em vez de tratar assign como uma fusão segura.

Exemplos

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

O exemplo mostra ordem das fontes, getter, Symbol, propriedade não enumerável omitida, referência partilhada e escrita parcial após erro.

Fontes