CKTIS / JavaScript
Sintaxe de acesso a propriedades
O ponto seleciona um nome fixo e os parênteses retos calculam a chave. Distingue o acesso privado e vê quando o encadeamento opcional evita uma leitura.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
obj.name
obj[expr]
obj.#name
obj?.name
obj?.[expr]
obj?.#nameEm obj.name, name designa uma chave textual fixa, não uma variável. Depois do ponto vem um IdentifierName: obj.default é válido, mas a chave "display-name" exige obj["display-name"]. Em obj[expr], o JavaScript avalia a expressão e converte o resultado numa chave: obtém um valor primitivo, mantém-no se for um Symbol e, caso contrário, converte-o numa cadeia de caracteres. Por isso, obj[1] e obj["1"] usam a mesma chave.
Num objeto comum, uma leitura pode encontrar uma propriedade própria ou herdada e chamar um getter. Uma propriedade ausente resulta em undefined, mas uma propriedade existente também pode ter esse valor. Usa Object.hasOwn(obj, key) para verificar se é própria. Tanto obj.name como obj["name"] podem ser alvos de atribuição, mas as regras da propriedade regem a escrita, que pode chamar um setter. obj.show() e obj["show"]() passam ambos obj como this; obter a função não a associa ao objeto.
obj.#name refere-se a um elemento privado, não a uma propriedade com a chave textual "#name". O nome privado tem de estar declarado num âmbito de classe acessível lexicalmente; caso contrário, o código produz um SyntaxError. Ler o elemento num objeto que não o possui lança um TypeError. obj["#name"] não lhe dá acesso.
Uma leitura normal sobre null ou undefined lança um TypeError. Com obj?.name ou obj?.[expr], qualquer um desses valores de base interrompe a cadeia contínua e devolve undefined, sem avaliar expr. obj?.#name continua sujeito às regras de acesso privado. ?. não interceta exceções lançadas por getters e uma cadeia opcional não pode ser alvo de atribuição.
Valida chaves de fontes não fiáveis com uma lista de nomes permitidos, sobretudo antes de escrever: uma chave não verificada pode selecionar uma propriedade inesperada e algumas escritas podem alterar um protótipo. Estas formas fazem parte do ECMAScript 2024, não das API do navegador; verifica o suporte no ambiente de execução de destino.
Exemplos
(() => {
const key = "display-name";
const token = Symbol("token");
const obj = {
name: "Ada",
[key]: "A. Lovelace",
1: "one",
[token]: "symbol",
show() { return this.name; },
};
console.log(obj.name);
console.log(obj[key]);
console.log(obj[1] === obj["1"]);
console.log(obj[token]);
console.log(obj["show"]());
console.log(obj.profile?.[key]);
})();Resultado
Ada A. Lovelace true symbol Ada undefined
O resultado `true` mostra que `1` e `"1"` selecionam a mesma chave. A chamada com parênteses retos mantém `obj` como `this`, e a última leitura é interrompida porque `profile` não existe.
Lições relacionadas
- JavaScript · Lição 20 · Avançado · Versão: 4