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

CKTIS / JavaScript

Desestruturação de objetos e sintaxe abreviada de propriedades

A desestruturação lê propriedades de um valor existente. A sintaxe abreviada cria, num novo objeto, propriedades com os mesmos nomes das variáveis das quais retira os valores.

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

Sintaxe

const { name, theme = "light" } = source;
const { name: displayName, [key]: selected, ...rest } = source;
let currentName;
({ name: currentName } = source);
const view = { displayName, theme };
const explicitView = { displayName: displayName, theme: theme };

As mesmas chavetas têm dois papéis. Em const { name } = source;, o padrão à esquerda lê source.name e declara name. Em const view = { name };, o literal à direita cria um objeto: { name } é a forma abreviada de { name: name }. É usado o valor atual da variável; atribuir-lhe outro valor mais tarde não altera a propriedade.

Em const { name: displayName } = source;, name é a chave de origem e displayName é a nova variável. Num padrão, { [key]: selected } calcula a chave a partir de key. Para atribuir um valor a uma variável existente, usa ({ name: displayName } = source);. Os parênteses envolvem toda a atribuição quando esta é uma instrução independente, para que a chaveta inicial não seja interpretada como o início de um bloco.

Em { theme = "light" }, o valor predefinido só é avaliado se a leitura devolver undefined, por exemplo se a propriedade não existir ou tiver sido definida explicitamente com esse valor. null não aciona o valor predefinido. Desestruturar null ou undefined como valor de origem lança um TypeError, mesmo com um padrão vazio.

Uma propriedade selecionada explicitamente pode ser encontrada na cadeia de protótipos. Já ...rest faz uma cópia superficial para um novo objeto apenas das propriedades próprias e enumeráveis restantes, incluindo as que têm chaves do tipo Symbol. Tem de ficar no fim do padrão, sem vírgula a seguir.

Esta é sintaxe de ECMAScript 2024, não uma funcionalidade do DOM. O suporte depende do ambiente de execução; em ambientes mais antigos, confirma em particular o suporte para as propriedades rest.

Exemplos

{
  const source = { name: "Ada", theme: undefined, note: null, active: true };
  const { name: displayName, theme = "light", note = "none", ...rest } = source;

  let active;
  ({ active } = rest);

  const view = { displayName, theme, note, active };
  console.log(JSON.stringify(view));
}

Resultado

{"displayName":"Ada","theme":"light","note":null,"active":true}

`name` é lido para `displayName`, `theme` recebe o valor predefinido `"light"` e `note` mantém-se a `null`. Em `rest` fica apenas `active`; uma atribuição separada lê essa propriedade antes de criar `view` com a sintaxe abreviada.

Lições relacionadas

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

Fontes