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

CKTIS / JavaScript

Parâmetro de função com desestruturação de arrays

Extraia valores de um único argumento iterável na assinatura de uma função e distinga o valor por omissão de um elemento do valor por omissão do parâmetro inteiro.

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

Sintaxe

function describe([first = "default", , ...rest] = []) {
  return JSON.stringify([first, rest]);
}

Um padrão de vinculação de array como [first, second] na lista de parâmetros desestrutura um único argumento antes de o corpo da função ser executado. Os nomes first e second ficam disponíveis no corpo. O padrão lê os valores pela ordem de iteração, pelo que o argumento pode ser um array ou outro iterável, como um Set. Um objeto comum com índices numéricos e uma propriedade length, mas sem iterador, provoca um TypeError.

Em [first = "default", , ...rest] = [], o = [] externo substitui um argumento omitido ou igual a undefined por um array vazio. O = "default" interno aplica-se quando o iterador não produz um primeiro valor ou produz undefined como primeiro valor. Passar null provoca um TypeError antes de o corpo ser executado; passar [null] associa first a null.

A posição vazia entre vírgulas ignora o segundo valor. O elemento rest ...rest recolhe todos os valores restantes num novo array. Tem de estar no fim do padrão, sem vírgula a seguir. Ao contrário do parâmetro rest em function f(...args) {}, recolhe valores de um único argumento e não os argumentos restantes da chamada.

Exemplos

function describe([first = "default", , ...rest] = []) {
  return JSON.stringify([first, rest]);
}

console.log(describe());
console.log(describe(["A", "skip", "B", "C"]));
console.log(describe(new Set([undefined, "skip", "Z"])));
console.log(describe([null]));

Resultado

["default",[]]
["A",["B","C"]]
["default",["Z"]]
[null,[]]

A primeira chamada usa ambos os valores por omissão. A segunda ignora `"skip"`; a terceira lê de um `Set` e usa o valor por omissão interno para `undefined`. A quarta mantém `null`.

Lições relacionadas

  • JavaScript · Lição 7 · Avançado · Versão: 4

Fontes