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

CKTIS / JavaScript

Vinculação por desestruturação de arrays

Um padrão de vinculação de array inicializa variáveis pela ordem de iteração. Permite saltar valores, definir valores por omissão e reunir os restantes num novo array.

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

Sintaxe

// Alternative declaration forms (use one):
{ const [first, , second = fallback, ...rest] = iterable; }
{ let [first, second] = iterable; }
var [first, second] = iterable;

function readPair([first, second]) {}
for (const [first, second] of pairs) {}

const [first, second] = iterable declara e inicializa duas variáveis. O padrão de vinculação também pode ser usado em declarações com let e var, em parâmetros de funções, em declarações em ciclos for...of e no parâmetro de catch. Já [first, second] = iterable é uma atribuição: não declara nada e pode escrever em destinos existentes que aceitem escrita, como obj.value, que não é um nome de vinculação.

O padrão obtém valores de um iterador síncrono, da esquerda para a direita, em vez de ler propriedades indexadas. Por isso, também funciona com Set. Um objeto com índices e length, mas sem iterador, provoca um TypeError, tal como null ou undefined quando usados como valor de entrada completo. Em [, second], a posição vazia salta o primeiro valor. Em second = fallback, a expressão por omissão só é avaliada se o valor for undefined ou se o iterador se tiver esgotado, não se o valor for null.

...rest reúne todos os valores restantes num novo array sem os copiar em profundidade. O elemento de resto tem de ser o último e não pode ser seguido de uma vírgula. Os padrões podem ser aninhados: [[first]] desestrutura o primeiro valor produzido, que tem de ser também iterável. Sem elemento de resto, o padrão não obtém valores adicionais. Se o iterador ainda não se tiver esgotado, JavaScript fecha-o, o que pode chamar o seu método return().

Exemplos

{
  const values = new Set([10, "skip", undefined, null, 30, 40]);
  const [first, , second = 20, kept = 99, ...rest] = values;
  console.log(JSON.stringify([first, second, kept, rest]));
}

Resultado

[10,20,null,[30,40]]

`Set` fornece os valores pela ordem de inserção. A posição vazia salta `"skip"`, `undefined` ativa o valor por omissão `20`, `null` mantém-se e `rest` contém `[30,40]`.

Lições relacionadas

  • JavaScript · Lição 17 · Intermédio · Versão: 3
  • JavaScript · Lição 20 · Intermédio · Versão: 3
  • JavaScript · Lição 22 · Intermédio · Versão: 3
  • JavaScript · Lição 35 · Intermédio · Versão: 3

Fontes