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

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?.#name

Em 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

Fontes