CKTIS / JavaScript
Declaração com desestruturação de objetos
Uma declaração com desestruturação de objetos cria ligações de variáveis a partir das propriedades da origem. O padrão permite escolher nomes, definir valores predefinidos e reunir as propriedades restantes.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const { property, key: local = fallback, [computedKey]: selected, nested: { inner } = {}, ...rest } = source;
let { property: mutable } = source;
var { property: variable } = source;Numa declaração normal como const { property } = source;, as chavetas delimitam um padrão de ligação, não um literal de objeto. A expressão source é o inicializador obrigatório. const e let têm âmbito de bloco; const impede a reatribuição da ligação, mas não a alteração de um objeto. Dentro de uma função, var tem âmbito de função, não de bloco.
{ key: local } lê key e declara local, não key. { [computedKey]: selected } calcula a chave, e um padrão aninhado lê propriedades no nível seguinte. Uma expressão predefinida só é avaliada se a leitura devolver undefined, por exemplo quando a propriedade não existe. Não substitui null, false nem 0. Desestruturar null ou undefined lança um TypeError, mesmo num padrão aninhado.
Uma propriedade selecionada explicitamente pode ser herdada. ...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 Symbol. Numa declaração, tem de ficar no fim, ligar um identificador e não ser seguido de vírgula. A desestruturação não valida os dados de entrada; a leitura de uma propriedade pode invocar um getter.
({ property } = source); atribui um valor a uma variável existente em vez de a declarar. No início de uma instrução, os parênteses impedem que { seja interpretada como o início de um bloco. A especificação ECMAScript 2024 define esta sintaxe; verifica se o ambiente de execução de destino a suporta.
Exemplos
{
const key = "theme";
const source = { name: "Ada", theme: null, active: false };
const {
name: displayName,
[key]: theme = "light",
settings: { density = "compact" } = {},
...rest
} = source;
console.log(JSON.stringify([displayName, theme, density, rest]));
}Resultado
["Ada",null,"compact",{"active":false}]`name` fica associado a `displayName` e `theme` mantém o valor `null`. Como falta `settings`, aplica-se primeiro o valor predefinido `{}` e depois `density` recebe `"compact"`. Em `rest` fica apenas `active: false`.
Lições relacionadas
- JavaScript · Lição 1 · Avançado · Versão: 4
- JavaScript · Lição 8 · Avançado · Versão: 4
- JavaScript · Lição 11 · Avançado · Versão: 4
Fontes
- ECMAScript 2024 Language Specification — Let and Const Declarations
- ECMAScript 2024 Language Specification — Variable Statement
- ECMAScript 2024 Language Specification — Destructuring Binding Patterns
- ECMAScript 2024 Language Specification — CopyDataProperties
- ECMAScript 2024 Language Specification — Destructuring Assignment
- MDN — Destructuring