CKTIS / JavaScript
Acesso a propriedades de objetos por chave calculada
Usa `obj[expr]` para ler ou atribuir um valor a uma propriedade escolhida por uma expressão, em vez de escrever um nome fixo após um ponto.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
obj[expr] // read using a computed key
obj[expr] = value // assign using a computed key
obj?.[expr] // optional computed access
obj.name // access the fixed string key "name"
({ [expr]: value }) // define a property in an object literalEm obj[expr], o JavaScript avalia expr para escolher a propriedade a ler ou à qual atribuir um valor. obj.key designa sempre a chave de texto "key"; obj[key] usa o valor da variável key. Já { [expr]: value } define uma propriedade ao criar um objeto, em vez de a ler num objeto existente.
ToPropertyKey converte primeiro o valor da chave num valor primitivo. Se o resultado 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. Os parênteses retos aceitam cadeias de caracteres com espaços, mas obj["#secret"] não acede ao campo privado de classe #secret.
Num objeto comum, uma leitura pode encontrar uma propriedade herdada ou chamar um getter. Se a propriedade não existir em toda a cadeia de protótipos, a leitura devolve undefined, tal como para uma propriedade com o valor undefined. Usa Object.hasOwn(obj, key) para verificar se a propriedade pertence diretamente ao objeto. Antes de leres ou escreveres com uma chave de origem não fiável, confirma que consta de uma lista de chaves permitidas; Object.hasOwn não substitui essa verificação.
Uma leitura normal sobre null ou undefined lança um TypeError se não ocorrer outro erro antes. Com esses valores de base, obj?.[expr] devolve undefined sem avaliar expr. Não interceta erros de getters nem pode servir de destino de uma atribuição. Trata-se de sintaxe JavaScript, não de uma API do DOM; confirma o suporte de ?. e Object.hasOwn em ambientes de execução mais antigos.
Exemplos
{
const key = "display count";
const tag = Symbol("status");
const obj = { key: 0, [key]: 2, [tag]: "ready" };
obj[key] = obj[key] + 1;
console.log(obj[key]);
console.log(obj.key);
console.log(obj[tag]);
const absent = null;
console.log(String(absent?.[key]));
}Resultado
3 0 ready undefined
`obj[key]` passa de `2` para `3`, mas `obj.key` continua a valer `0`. `obj[tag]` lê `ready` através de uma chave do tipo `Symbol`, e o acesso opcional sobre `null` devolve `undefined`.
Lições relacionadas
- JavaScript · Lição 38 · Avançado · Versão: 4
- JavaScript · Lição 44 · Avançado · Versão: 4