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

CKTIS / JavaScript

Desestruturação de arrays em parâmetros de função

Um padrão de array na lista de parâmetros desestrutura um único argumento iterável. Os valores predefinidos do argumento e dos elementos são independentes.

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

Sintaxe

function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }

Na lista de parâmetros, [first, third] é um padrão de vinculação de array que desestrutura um único argumento, não dois parâmetros separados. Em cada chamada, o padrão inicializa os nomes locais pela ordem de iteração, antes de o corpo da função ser executado. Pode passar-se um array ou outro iterável, como um Set; um objeto comum com chaves numéricas e uma propriedade length não basta.

Em [first = 1, , third = 3, ...rest], a posição vazia entre vírgulas faz com que o segundo valor seja ignorado. ...rest reúne os valores restantes num novo array. É um elemento rest do padrão, não um parâmetro rest que reúne argumentos distintos da chamada. Tem de vir no fim, sem vírgula a seguir.

O = [] exterior substitui o argumento inteiro apenas se for omitido ou for undefined. Os valores predefinidos internos = 1 e = 3 aplicam-se se o valor correspondente estiver em falta ou for undefined. Um null dentro do array mantém-se null. Se o argumento inteiro for null ou outro valor não iterável, ocorre um TypeError antes de o corpo ser executado. Sem = [], omitir o argumento ou passar undefined também provoca um TypeError.

Exemplos

function describe([first = 1, , third = 3, ...rest] = []) {
  return [first, third, rest];
}

console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));

try {
  describe(null);
} catch (error) {
  console.log(error.name);
}

Resultado

[1,3,[]]
[1,null,[40,50]]
[10,30,[]]
TypeError

A primeira chamada usa os dois níveis de valores predefinidos. Na segunda, `20` é ignorado, `null` mantém-se e `rest` é `[40,50]`. A terceira mostra que um `Set` também funciona. A última apresenta o nome do erro em vez de uma mensagem específica do ambiente de execução.

Lições relacionadas

  • JavaScript · Lição 28 · Intermédio · Versão: 3

Fontes