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

CKTIS / JavaScript

Desestruturação de objetos, parâmetros predefinidos e propriedades abreviadas

Lê opções a partir de um único argumento, distingue o valor predefinido do parâmetro inteiro dos valores predefinidos das propriedades e cria o resultado com a sintaxe abreviada.

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

Sintaxe

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

Na assinatura de configure, { limit: maxItems = 10, enabled = true } é um padrão de desestruturação. A função recebe um único argumento posicional, não argumentos com nome. O padrão lê limit para a variável local maxItems e enabled para uma variável com o mesmo nome.

O = {} exterior cria um novo objeto vazio quando o argumento é omitido ou é explicitamente undefined. Os valores predefinidos interiores = 10 e = true aplicam-se de forma independente, apenas quando a leitura da propriedade correspondente dá undefined, incluindo quando não se encontra a propriedade. Os valores de propriedade null, 0, false e "" são mantidos. Em contrapartida, configure(null) lança um TypeError antes de o corpo da função ser executado. Sem o = {} exterior, omitir o argumento também lançaria um TypeError.

As expressões predefinidas são avaliadas no momento da chamada e apenas quando necessário. Podem usar parâmetros anteriores já inicializados, mas não declarações no corpo da função. A leitura de uma propriedade pode percorrer a cadeia de protótipos ou invocar um getter, pelo que o padrão não verifica o tipo do valor nem se a propriedade pertence diretamente ao objeto.

Em return { maxItems, enabled }, as chavetas delimitam um literal que cria um novo objeto, não um padrão. Aqui, a sintaxe abreviada tem o mesmo efeito que { maxItems: maxItems, enabled: enabled }: as chaves provêm dos nomes locais, pelo que o resultado tem a chave maxItems, não limit. Esta sintaxe está especificada em ECMAScript 2024; confirma o suporte nos ambientes de execução mais antigos que pretendes usar.

Exemplos

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

console.log(JSON.stringify(configure()));
console.log(JSON.stringify(configure(undefined)));
console.log(JSON.stringify(configure({ limit: 0, enabled: false })));
console.log(JSON.stringify(configure({ limit: undefined, enabled: null })));

try {
  configure(null);
} catch (error) {
  console.log(error.name);
}

Resultado

{"maxItems":10,"enabled":true}
{"maxItems":10,"enabled":true}
{"maxItems":0,"enabled":false}
{"maxItems":10,"enabled":null}
TypeError

As duas primeiras chamadas produzem o mesmo resultado. A terceira mantém `0` e `false`, a quarta substitui apenas `undefined` e a última escreve `TypeError` na consola porque o argumento inteiro é `null`.

Lições relacionadas

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

Fontes