CKTIS / JavaScript
Sintaxe dos parâmetros com valor predefinido
Usa `parâmetro = expressão` na definição de uma função para fornecer um valor quando o argumento correspondente é omitido ou tem o valor `undefined`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
function f(a, b = a) { /* ... */ }
const g = (a, b = a) => b;
function h({ x = 1 } = {}) { return x; }Escreve parâmetro = expressão na lista de parâmetros de uma função, de um método ou de uma função de seta. O valor predefinido só é usado se o argumento nessa posição for omitido ou tiver o valor undefined. null, false, 0 e "" mantêm-se inalterados. Para usar o valor predefinido numa posição anterior e fornecer um argumento numa posição posterior, passa undefined na posição anterior.
Os parâmetros são inicializados da esquerda para a direita antes de o corpo da função ser executado. Um inicializador é avaliado a cada chamada que dele precisa, pelo que items = [] cria um novo array sempre que esse valor predefinido é usado. Um inicializador pode ler um parâmetro anterior, mas ler um parâmetro posterior antes de este ser inicializado faz lançar um ReferenceError. As declarações no corpo da função não são visíveis para os inicializadores dos parâmetros.
Em function h({ x = 1 } = {}) { return x; }, o = {} exterior aplica-se quando o argumento é omitido ou vale undefined. O x = 1 interior aplica-se se a propriedade x não existir ou valer undefined. h(null) lança um TypeError: o valor predefinido exterior não substitui null e não é possível desestruturar null.
Um parâmetro sem valor predefinido pode aparecer depois de um parâmetro com valor predefinido, mas não conta para length. Esta propriedade conta apenas os parâmetros anteriores ao primeiro inicializador de um parâmetro inteiro e exclui sempre o parâmetro rest. O parâmetro rest não pode ter um inicializador.
Exemplos
{
function collect(value, label = value, items = []) {
items.push(label);
return items;
}
console.log(JSON.stringify(collect("A")));
console.log(JSON.stringify(collect("B", undefined)));
console.log(JSON.stringify(collect("C", null)));
console.log(JSON.stringify(collect("D", false, ["start"])));
console.log(String(collect.length));
}Resultado
["A"] ["B"] [null] ["start",false] 1
Omitir `label` ou passar `undefined` faz com que seja usado `value`, mas `null` e `false` são preservados. As três primeiras chamadas criam arrays distintos; a quarta acrescenta um elemento ao array fornecido. `collect.length` vale `1` porque só `value` é contado.
Lições relacionadas
- JavaScript · Lição 21 · Avançado · Versão: 4
- JavaScript · Lição 27 · Avançado · Versão: 4
- JavaScript · Lição 29 · Avançado · Versão: 4
- JavaScript · Lição 44 · Avançado · Versão: 4
- JavaScript · Lição 45 · Avançado · Versão: 4