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