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

CKTIS / JavaScript

Atualizações imutáveis e partilha estrutural

Cria um novo estado sem alterar o anterior: copia os contentores ao longo do caminho da alteração e reutiliza os ramos que não mudaram.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

const next = { ...state, profile: { ...state.profile, name: newName } };
const nextItems = items.with(index, replacement);

Uma atualização imutável cria uma nova versão do estado sem alterar a anterior. Se o estado tiver a forma de uma árvore, cria novos contentores desde a raiz até ao ponto da alteração e reutiliza os mesmos objetos nos ramos inalterados. Esta reutilização é a partilha estrutural. Para objetos, === verifica a identidade, não a igualdade do conteúdo. Se nada mudar, podes devolver a raiz original.

A sintaxe de expansão ... num literal de objeto copia superficialmente os valores das propriedades próprias enumeráveis. Não copia o protótipo da origem e uma entrada posterior com a mesma chave substitui a anterior. { ...state } por si só não copia state.profile: escrever em profile.name através dessa cópia superficial também alteraria a versão anterior. Não alteres os ramos partilhados através de nenhuma referência.

Nos arrays, items.with(index, replacement) devolve um novo array sem escrever em items e preserva a identidade dos objetos nas outras posições. Os índices negativos contam a partir do fim; um índice fora dos limites após a normalização lança um RangeError. A cópia ao longo do caminho evita copiar ramos inteiros que não mudaram, mas copia as entradas de cada contentor reconstruído. Por isso, copiar um único array grande ainda pode ser dispendioso.

Array.prototype.with faz parte do ECMAScript 2024; verifica se o ambiente de execução de destino o suporta. structuredClone() é uma API distinta da plataforma Web: para uma árvore comum de dados clonáveis, cria uma cópia profunda em vez de partilhar ramos com a origem. Nem todos os valores podem ser clonados; por exemplo, uma função provoca um DataCloneError.

Exemplos

{
  const state = {
    profile: { name: "Ada" },
    settings: { theme: "dark" },
  };

  const next = {
    ...state,
    profile: { ...state.profile, name: "Grace" },
  };

  console.log(`names: ${state.profile.name} -> ${next.profile.name}`);
  console.log(`same root: ${state === next}`);
  console.log(`same profile: ${state.profile === next.profile}`);
  console.log(`same settings: ${state.settings === next.settings}`);
}

Resultado

names: Ada -> Grace
same root: false
same profile: false
same settings: true

`state.profile.name` continua a ser `Ada`, ao passo que `next.profile.name` é `Grace`. A raiz e `profile` são objetos novos; `settings` é o mesmo objeto nas duas versões.

Lições relacionadas

  • JavaScript · Lição 18 · Avançado · Versão: 4

Fontes