CKTIS / JavaScript
Desestruturação de objetos
A desestruturação de objetos lê propriedades pela chave, não pela posição. Permite declarar variáveis, atribuir valores a destinos existentes, definir valores predefinidos e reunir as propriedades restantes.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const { name, theme: colorTheme = "light", ...rest } = profile;
let score;
({ points: score } = profile);
const { [key]: value, settings: { mode } = {} } = options;
function readName({ name = "Guest" } = {}) { return name; }A desestruturação de objetos usa um padrão entre {} para ler propriedades pela chave. Em const { name } = profile, a variável name recebe o valor de profile.name. O padrão { name: displayName } lê a mesma chave e guarda o valor na variável displayName, sem mudar o nome da propriedade. Em { [key]: value }, a chave é calculada; { settings: { mode } } lê uma propriedade aninhada e cria uma ligação apenas para mode.
Numa declaração com const, let ou var, ou num parâmetro de função, o padrão cria ligações. A atribuição ({ points: score } = profile) escreve na variável existente score; uma propriedade que admita escrita também pode ser o destino. Numa instrução isolada, os parênteses impedem que a chaveta inicial seja interpretada como o início de um bloco.
Em { theme = "light" }, a expressão predefinida só é avaliada se a leitura devolver undefined, por exemplo quando a propriedade não é encontrada. Valores como null, false e 0 mantêm-se. Aplicar um padrão de objeto a null ou undefined provoca um TypeError, mesmo num padrão aninhado. Em function readName({ name = "Guest" } = {}), o valor predefinido do parâmetro = {} aplica-se se o argumento for omitido ou for undefined, mas não se for null.
A procura de uma chave explícita pode encontrar uma propriedade herdada. Já ...rest copia para um novo objeto apenas as propriedades próprias e enumeráveis restantes, incluindo as que têm chaves do tipo símbolo. A cópia é superficial: os valores que são objetos continuam a ser partilhados. ...rest tem de ficar no fim, sem vírgula a seguir.
Esta é sintaxe de ECMAScript 2024, não uma API do navegador. Em ambientes JavaScript mais antigos, verifica se as formas usadas são suportadas, em especial ...rest.
Exemplos
{
const profile = { name: "Mira", theme: undefined, badge: null, points: 7 };
const { name: displayName, theme = "light", badge = "none", ...rest } = profile;
let score;
({ points: score } = profile);
console.log(`${displayName} | ${theme} | ${badge} | ${score} | ${Object.keys(rest).join(",")}`);
}Resultado
Mira | light | null | 7 | points
`displayName` recebe o valor de `name`, `theme` assume o valor predefinido e `badge` mantém-se como `null`. A atribuição escreve `7` em `score`; `points` é a única chave de `rest`.
Lições relacionadas
- JavaScript · Lição 39 · Avançado · Versão: 4
- JavaScript · Lição 5 · Básico · Versão: 4
- JavaScript · Lição 18 · Básico · Versão: 4
- JavaScript · Lição 2 · Intermédio · Versão: 3
- JavaScript · Lição 8 · Intermédio · Versão: 3
- JavaScript · Lição 10 · Intermédio · Versão: 3