CKTIS / JavaScript
Desestruturação de parâmetros de funções
Escreve padrões na lista de parâmetros para ler propriedades de objetos ou valores de iteráveis. Distingue o valor predefinido do parâmetro inteiro dos valores predefinidos dentro do padrão.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }Desestruturar parâmetros significa escrever um padrão de vinculação diretamente na lista de parâmetros da função. Num parâmetro comum, o padrão usa o valor correspondente a uma única posição na lista de argumentos e cria associações a nomes locais disponíveis no corpo da função. Um parâmetro rest (...) também pode usar um padrão de vinculação, mas nesse caso o padrão desestrutura o array que contém os argumentos restantes. Os argumentos continuam a ser passados por posição, não por nome.
O padrão de objeto { label } lê a propriedade pelo nome e cria uma associação ao nome local label. { label: name } lê a mesma propriedade, mas associa o valor ao nome local name. O padrão de array [count] obtém o primeiro valor pela ordem de iteração, quer seja de um array ou de outro iterável.
Os valores predefinidos externos = {} e = [] substituem o argumento inteiro antes da desestruturação, mas apenas se for omitido ou tiver o valor undefined. Os valores predefinidos internos, como em name = "untitled" e count = 1, só se aplicam se o valor extraído for undefined, por exemplo quando falta uma propriedade ou o iterador já não fornece outro valor. null, 0, false e "" não ativam os valores predefinidos.
Passar null como argumento inteiro a qualquer um dos padrões lança um TypeError antes de o corpo da função ser executado. Sem um valor predefinido externo, omitir o argumento ou passar undefined provoca o mesmo erro. Um padrão de array também lança um TypeError para um valor não iterável. A desestruturação não substitui a validação dos dados de entrada.
Exemplos
function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
return `${name}: ${count}`;
}
console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));Resultado
untitled: 1 draft: 0 null: 1
A primeira chamada usa os dois níveis de valores predefinidos. A segunda mantém `0`. Na terceira, `label` tem o valor `null` e não é substituído, ao passo que o array vazio ativa `count = 1`.
Lições relacionadas
- JavaScript · Lição 2 · Intermédio · Versão: 3