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

CKTIS / JavaScript

Desestruturação de objetos e valores iteráveis

A desestruturação lê propriedades de objetos ou valores sucessivos de um objeto iterável através de um padrão. Permite declarar variáveis, atribuir valores a variáveis existentes, mudar o nome de ligações, fornecer valores predefinidos e recolher os valores ou propriedades restantes.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const { key: localName = fallback, ...rest } = object;
const [first, , third = fallback, ...tail] = iterable;
({ key: existingVariable } = object);

A desestruturação (destructuring) é uma sintaxe de padrões, não uma função nem uma palavra-chave. Um padrão de objeto como { key } lê uma propriedade pela respetiva chave, enquanto [first] consome um valor de um iterador — a origem não tem de ser um array. Os padrões podem ser aninhados e também usados em parâmetros de funções.

A declaração const { key: localName = fallback } = object cria localName, não key. Um valor predefinido só é avaliado quando o valor extraído é undefined, incluindo quando a propriedade não existe; null, 0 e false não o acionam. A desestruturação de null ou undefined gera um TypeError; um padrão de array exige um valor iterável.

Uma vírgula num padrão de array permite ignorar uma posição. Um ...tail no final recolhe os valores restantes do iterador num novo array; ...rest num padrão de objeto copia as propriedades próprias enumeráveis restantes para um novo objeto. Rest tem de ser o último elemento e não pode ter uma vírgula a seguir. Não se trata de uma cópia profunda: os objetos aninhados continuam a ser referências partilhadas.

Uma declaração cria ligações, enquanto uma atribuição atualiza destinos existentes. Quando uma atribuição de objeto inicia uma instrução, usa parênteses: ({ key: existingVariable } = object);, para que { não inicie um bloco. No exemplo, userName recebe "Ada" e os valores undefined acionam os valores predefinidos.

Exemplos

const record = { name: "Ada", score: undefined, active: true };
const { name: userName, score = 10, ...rest } = record;
const [first, , third = 9, ...tail] = [2, 4, undefined, 8];
console.log(`${userName}|${score}|${rest.active}|${first}|${third}|${tail.join(",")}`);

Resultado

Ada|10|true|2|9|8

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes