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

CKTIS / JavaScript

Desestruturação de objetos, propriedades abreviadas e acesso por chave calculada

Distingue a extração de valores para variáveis, a notação abreviada ao criar propriedades e o acesso através de chaves calculadas durante a execução.

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

Sintaxe

// Define properties: shorthand and computed key
const obj = { name, [key]: value };

// Bind values: same name, rename, default, computed key, and rest
const { name: alias, active, level = 1, [key]: selected, ...rest } = obj;

// Assign to an existing writable variable
let current;
({ name: current } = obj);

// Read properties: fixed key and computed key
obj.name;
obj["name"];
obj[key];

Em const { name } = obj, a desestruturação lê a propriedade name e declara uma variável com o mesmo nome. Em const { name: alias } = obj, a chave fica à esquerda dos dois pontos e o nome da nova variável à direita. Para uma atribuição autónoma a uma variável existente e modificável, usa ({ name: alias } = obj);: os parênteses impedem que { seja interpretado como o início de um bloco.

No literal de objeto const obj = { name }, a forma abreviada name significa name: name: a variável existente fornece o valor da nova propriedade. Num literal, [key]: value define uma propriedade; num padrão de desestruturação, [key]: alias lê uma propriedade e guarda o valor em alias. Em ambos os casos, a expressão entre parênteses retos determina a chave. Se a expressão produzir um objeto, o JavaScript converte-o primeiro num valor primitivo. Se o valor primitivo for um símbolo (Symbol), é usado como chave sem alterações; caso contrário, é convertido numa cadeia de caracteres. A conversão pode lançar uma exceção.

obj.name e obj["name"] leem a mesma chave fixa; obj[key] avalia key para determinar a chave. Tanto a leitura normal como a leitura explícita de uma propriedade na desestruturação podem encontrar propriedades herdadas. Antes de usares chaves provenientes de dados não fiáveis, confirma que constam de uma lista de chaves permitidas.

Um valor por omissão como level = 1 só é avaliado quando a leitura devolve undefined, não quando devolve null. Desestruturar diretamente null ou undefined lança um TypeError. ...rest tem de ficar no fim, sem vírgula a seguir: cria uma cópia superficial das restantes propriedades próprias enumeráveis num novo objeto, incluindo as que têm chaves do tipo símbolo. A sintaxe está especificada no ECMAScript 2024; verifica se é suportada pelo ambiente de execução de destino.

Exemplos

{
  const name = "Ada";
  const key = "total-score";
  const obj = { name, [key]: 7, active: true, note: null, tag: "demo" };
  const { name: alias, [key]: score, active, level = 1, note = "none", ...rest } = obj;
  console.log(`${alias} | ${score} | ${obj[key]} | ${active} | ${level} | ${note} | ${rest.tag}`);
}

Resultado

Ada | 7 | 7 | true | 1 | null | demo

`[key]: score` e `obj[key]` leem ambos `7`; como `level` não existe, assume o valor por omissão `1`, `note` mantém-se `null` e `tag` é copiado para `rest`.

Lições relacionadas

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

Fontes