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

CKTIS / JavaScript

Parâmetros predefinidos

Um parâmetro predefinido usa a sua expressão de inicialização quando um argumento é omitido ou passado explicitamente como undefined. Valores como null, 0, false e uma cadeia vazia não acionam o valor predefinido.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

function name(parameter = expression) { /* body */ }

Um parâmetro predefinido tem uma expressão de inicialização escrita como parameter = expression na lista de parâmetros de uma função. A expressão fornece um valor quando o argumento correspondente é omitido ou tem o valor undefined.

Os valores null, 0, false e "" permanecem inalterados. Isto não é equivalente a parameter || fallback, que também substitui outros valores falsy. Um valor predefinido também não valida o tipo do argumento.

As expressões de inicialização são avaliadas no momento da chamada, apenas quando necessário, da esquerda para a direita. Um parâmetro posterior pode usar um anterior, como em label = value. Ler um parâmetro posterior que ainda não foi inicializado gera um ReferenceError. Uma expressão como [] ou {} cria um novo objeto sempre que é avaliada.

As expressões de inicialização não podem aceder às declarações locais no corpo da função. Coloque os valores auxiliares num âmbito externo acessível ou calcule-os no corpo. O exemplo demonstra a diferença entre valores omitidos e explícitos, bem como a dependência de label em relação a value.

Exemplos

function describe(value = "guest", label = value) {
  return JSON.stringify([value, label]);
}

console.log(describe());
console.log(describe(undefined));
console.log(describe(null));
console.log(describe(0));
console.log(describe(false));
console.log(describe(""));

Resultado

["guest","guest"]
["guest","guest"]
[null,null]
[0,0]
[false,false]
["",""]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes