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

CKTIS / JavaScript

Desestruturação de arrays

Extrai valores de um iterável pela sua ordem de iteração, ignora posições, define valores por omissão e reúne os restantes valores num novo array.

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

Sintaxe

const [first, , third = 20, ...rest] = iterable;
let value;
[value] = iterable;

A desestruturação de arrays usa um padrão [...] para extrair valores pela ordem de iteração. Ao contrário da desestruturação de objetos ({...}), não seleciona propriedades pelo nome. Do lado direito pode estar um array ou outro valor iterável, como um Set. As chaves numéricas e uma propriedade length não bastam: uma origem não iterável provoca um TypeError.

Em const [a, b] = iterable, o padrão declara novas variáveis. A atribuição [a, b] = iterable não declara nada: atribui valores a a e b. Se um identificador do lado esquerdo não puder ser resolvido, a atribuição lança um ReferenceError em modo estrito. Num script executado fora do modo estrito, pode, em vez disso, criar uma propriedade no objeto global. A posição vazia em [a, , b] ignora o segundo valor produzido pelo iterador.

Se o iterador se esgotar, os valores em falta são tratados como undefined. A expressão do valor por omissão em a = 10 só é avaliada quando o valor destinado a a é undefined, e não quando é null, 0 ou false.

Em [a, ...rest], o elemento de resto ...rest reúne os valores restantes num novo array, vazio se não restar nenhum. Tem de ficar em último lugar e não pode ser seguido de vírgula. É sintaxe de JavaScript definida em ECMAScript 2024, não uma API do navegador; verifica se é suportada no ambiente de execução de destino.

Exemplos

let [first = 10, , third = 20, ...rest] = [undefined, 99, null, 30, 40];
console.log(`${first} | ${third} | ${JSON.stringify(rest)}`);

[first] = new Set([5]);
console.log(first);

Resultado

10 | null | [30,40]
5

`first` recebe o valor por omissão `10`, `99` é ignorado, `third` mantém `null` e `rest` é `[30,40]`. A atribuição seguinte obtém `5` do `Set` e guarda-o na variável `first` já existente.

Lições relacionadas

  • JavaScript · Lição 32 · Avançado · Versão: 4
  • JavaScript · Lição 36 · Avançado · Versão: 4
  • JavaScript · Lição 37 · Avançado · Versão: 4
  • JavaScript · Lição 41 · Avançado · Versão: 4
  • JavaScript · Lição 4 · Básico · Versão: 4
  • JavaScript · Lição 2 · Intermédio · Versão: 3

Fontes