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}
TypeErrorAs 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