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