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

CKTIS / JavaScript

Acesso a propriedades em JavaScript

A notação de ponto indica uma chave fixa; os parênteses retos permitem calculá-la. Uma leitura ou atribuição pode chamar um getter ou um setter.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

obj.name
obj[expression]
obj.name = value
obj[expression] = value
obj?.name
obj?.[expression]

({
  get name() { return this.saved; },
  set name(value) { this.saved = value; }
})

obj.name usa a cadeia de caracteres "name" como chave, quer exista ou não uma variável chamada name. obj[key] avalia a expressão entre parênteses retos e converte o resultado numa chave do tipo string ou Symbol. Usa parênteses retos para chaves dinâmicas, símbolos e nomes como obj["first-name"]. O acesso a um elemento privado de uma classe através de obj.#name é distinto: obj["#name"] não é equivalente.

Num objeto comum, uma leitura procura primeiro uma propriedade do próprio objeto e depois percorre a cadeia de protótipos. Se não encontrar a propriedade, devolve undefined. Uma propriedade de dados guarda um valor; uma propriedade de acesso pode, em vez disso, definir um getter (get) ou um setter (set). A leitura chama o getter sem argumentos e a atribuição passa o valor atribuído ao setter. Atribuir um valor a uma propriedade de acesso sem setter lança um TypeError em modo estrito; fora desse modo, a atribuição é ignorada.

Uma leitura normal sobre null ou undefined lança um TypeError. obj?.name e obj?.[key] devolvem undefined se obj tiver um desses dois valores. Nesse caso, a expressão key não é avaliada. ?. não interceta exceções lançadas por um getter e não pode ser usado no lado esquerdo de uma atribuição.

Exemplos

{
  const key = 'value';
  const label = Symbol('label');
  const counter = {
    count: 2,
    [label]: 'counter',
    get value() { return this.count; },
    set value(next) { this.count = next; }
  };

  console.log(`${counter[label]}: ${counter.value}`);
  counter[key] = 5;
  console.log(`${counter.count} / ${counter[key]}`);

  const missing = null;
  console.log(String(missing?.[key]));
}

Resultado

counter: 2
5 / 5
undefined

`counter[label]` lê uma propriedade cuja chave é um `Symbol`. Tanto `counter.value` como `counter[key]` chamam o getter de `value`; a atribuição com parênteses retos chama o setter, que atualiza `count`. A última leitura termina ao encontrar `null`.

Lições relacionadas

  • JavaScript · Lição 1 · Avançado · Versão: 4
  • JavaScript · Lição 2 · Avançado · Versão: 4
  • JavaScript · Lição 3 · Avançado · Versão: 4
  • JavaScript · Lição 4 · Avançado · Versão: 4
  • JavaScript · Lição 5 · Avançado · Versão: 4
  • JavaScript · Lição 6 · Avançado · Versão: 4
  • JavaScript · Lição 7 · Avançado · Versão: 4
  • JavaScript · Lição 8 · Avançado · Versão: 4
  • JavaScript · Lição 9 · Avançado · Versão: 4
  • JavaScript · Lição 10 · Avançado · Versão: 4
  • JavaScript · Lição 11 · Avançado · Versão: 4
  • JavaScript · Lição 12 · Avançado · Versão: 4
  • JavaScript · Lição 13 · Avançado · Versão: 4
  • JavaScript · Lição 14 · Avançado · Versão: 4
  • JavaScript · Lição 15 · Avançado · Versão: 4
  • JavaScript · Lição 16 · Avançado · Versão: 4
  • JavaScript · Lição 17 · Avançado · Versão: 4
  • JavaScript · Lição 18 · Avançado · Versão: 4
  • JavaScript · Lição 19 · Avançado · Versão: 4
  • JavaScript · Lição 12 · Intermédio · Versão: 3
  • JavaScript · Lição 13 · Intermédio · Versão: 3
  • JavaScript · Lição 14 · Intermédio · Versão: 3
  • JavaScript · Lição 15 · Intermédio · Versão: 3
  • JavaScript · Lição 16 · Intermédio · Versão: 3
  • JavaScript · Lição 17 · Intermédio · Versão: 3
  • JavaScript · Lição 18 · Intermédio · Versão: 3
  • JavaScript · Lição 19 · Intermédio · Versão: 3
  • JavaScript · Lição 20 · Intermédio · Versão: 3
  • JavaScript · Lição 21 · Intermédio · Versão: 3
  • JavaScript · Lição 22 · Intermédio · Versão: 3
  • JavaScript · Lição 23 · Intermédio · Versão: 3
  • JavaScript · Lição 24 · Intermédio · Versão: 3
  • JavaScript · Lição 25 · Intermédio · Versão: 3
  • JavaScript · Lição 26 · Intermédio · Versão: 3
  • JavaScript · Lição 27 · Intermédio · Versão: 3
  • JavaScript · Lição 28 · Intermédio · Versão: 3
  • JavaScript · Lição 29 · Intermédio · Versão: 3
  • JavaScript · Lição 30 · Intermédio · Versão: 3
  • JavaScript · Lição 31 · Intermédio · Versão: 3
  • JavaScript · Lição 32 · Intermédio · Versão: 3
  • JavaScript · Lição 33 · Intermédio · Versão: 3
  • JavaScript · Lição 34 · Intermédio · Versão: 3
  • JavaScript · Lição 35 · Intermédio · Versão: 3
  • JavaScript · Lição 36 · Intermédio · Versão: 3
  • JavaScript · Lição 37 · Intermédio · Versão: 3
  • JavaScript · Lição 38 · Intermédio · Versão: 3
  • JavaScript · Lição 39 · Intermédio · Versão: 3
  • JavaScript · Lição 40 · Intermédio · Versão: 3
  • JavaScript · Lição 41 · Intermédio · Versão: 3
  • JavaScript · Lição 42 · Intermédio · Versão: 3
  • JavaScript · Lição 43 · Intermédio · Versão: 3

Fontes