CKTIS / JavaScript
Acesso a propriedades através de uma chave calculada
A notação com parênteses retos `obj[expr]` seleciona uma propriedade a partir do valor de uma expressão. Permite ler e escrever propriedades e chamar métodos cujas chaves são determinadas em tempo de execução.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
object[expression]
object[expression] = value
object[expression](...args)
object?.[expression]Em obj[expr], o valor de expr determina a chave da propriedade. obj.key usa sempre a cadeia de caracteres "key", enquanto obj[key] usa o valor da variável key. Os parênteses retos também permitem chaves com espaços. Em { [expr]: value }, indicam um nome de propriedade calculado: define-se uma propriedade num literal de objeto, em vez de a ler de um objeto existente.
ToPropertyKey converte o valor da chave num valor primitivo. Se este for um Symbol, mantém-no; caso contrário, converte-o numa cadeia de caracteres. Assim, obj[1] e obj["1"] referem-se à mesma propriedade. A conversão de um objeto usado como chave pode executar código e lançar uma exceção.
Uma leitura normal pode percorrer a cadeia de protótipos e invocar um getter. Uma propriedade ausente dá undefined, mas uma propriedade existente também pode dar undefined. Object.hasOwn(obj, key) verifica se a propriedade pertence diretamente ao objeto. obj[key] = value segue as regras normais de atribuição e uma chamada direta obj[key]() tem obj como recetor, tal como obj.method().
Ler diretamente de null ou undefined lança um TypeError. Com um desses valores como base, obj?.[expr] devolve undefined sem avaliar expr; esta forma não pode ser o destino de uma atribuição. O acesso com parênteses retos é sintaxe ECMAScript, não uma API do navegador. Confirma que o ambiente de destino suporta ?. e Object.hasOwn.
Os parênteses retos não validam chaves externas. Antes de ler ou escrever com base em dados não fiáveis, limita as chaves a uma lista explícita de valores permitidos. Object.hasOwn, por si só, não verifica permissões.
Exemplos
{
const key = "total points";
const token = Symbol("bonus");
const scores = { [key]: 7, [token]: 2, "1": "first" };
console.log(`before: ${scores[key]}`);
scores[key] = 9;
console.log(`after: ${scores[key]}`);
console.log(`literal key: ${scores.key}`);
console.log(`symbol key: ${scores[token]}`);
console.log(`numeric key: ${scores[1]}`);
let evaluations = 0;
const missing = null;
console.log(`optional: ${missing?.[evaluations++]}`);
console.log(`evaluations: ${evaluations}`);
}Resultado
before: 7 after: 9 literal key: undefined symbol key: 2 numeric key: first optional: undefined evaluations: 0
O exemplo altera o valor associado a uma chave com um espaço e mostra que `scores.key` procura a chave literal `"key"`. O último acesso não avalia `evaluations++`, pelo que o contador se mantém em `0`.
Lições relacionadas
- JavaScript · Lição 24 · Avançado · Versão: 4
- JavaScript · Lição 25 · Avançado · Versão: 4
- JavaScript · Lição 29 · Avançado · Versão: 4