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

CKTIS / JavaScript

PropertyDescriptor.value — valor de uma propriedade de dados

O campo `value` contém o valor armazenado numa propriedade de dados. Omiti-lo no descritor fornecido não equivale a escrever `value: undefined`.

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

Sintaxe

Object.defineProperty(target, key, { value: newValue })
const descriptor = Object.getOwnPropertyDescriptor(target, key);
if (descriptor !== undefined && Object.hasOwn(descriptor, "value")) {
  const storedValue = descriptor.value;
}

PropertyDescriptor.value designa o campo value do objeto que descreve uma propriedade de dados, não uma propriedade de um construtor global. Corresponde ao campo [[Value]] da especificação e pode conter qualquer valor de JavaScript, incluindo um objeto, uma função ou undefined. writable determina se uma atribuição pode substituir o valor; não congela um objeto armazenado.

Num objeto comum, Object.defineProperty() usa undefined por omissão ao criar uma propriedade de dados sem o campo value. Ao alterar uma propriedade de dados existente sem mudar o seu tipo, omitir value mantém o valor anterior, ao passo que value: undefined pede a sua substituição. Se a propriedade de dados existente não for configurável nem gravável, fornecer um valor diferente segundo SameValue (a comparação usada por Object.is) lança um TypeError.

Um descritor de acesso usa get e set em vez de value e writable. Não se podem misturar campos dos dois grupos no descritor fornecido: até { value: undefined, get: undefined } lança um TypeError. Os campos herdados pelo descritor fornecido também são tidos em conta.

Object.getOwnPropertyDescriptor() devolve undefined se não existir uma propriedade própria para a chave. Se devolver um descritor, Object.hasOwn(descriptor, "value") distingue uma propriedade de dados que contém undefined de uma propriedade de acesso. O descritor não acompanha a propriedade em tempo real: alterar descriptor.value não substitui o valor no objeto de destino. Se o valor armazenado for um objeto, o descritor refere-se ao mesmo objeto, não a uma cópia.

Exemplos

{
  const target = { score: 7, get label() { return "ready"; } };
  const before = Object.getOwnPropertyDescriptor(target, "score");

  Object.defineProperty(target, "score", { enumerable: false });
  console.log(String(target.score));

  Object.defineProperty(target, "score", { value: undefined });
  const data = Object.getOwnPropertyDescriptor(target, "score");
  const accessor = Object.getOwnPropertyDescriptor(target, "label");

  console.log(`${Object.hasOwn(data, "value")}: ${data.value}`);
  console.log(`${Object.hasOwn(accessor, "value")}: ${target.label}`);
  console.log(String(before.value));
}

Resultado

7
true: undefined
false: ready
7

Omitir `value` mantém `7`; indicar `value: undefined` substitui o valor. O descritor de `label` não tem um campo próprio `value`, embora ler `target.label` invoque o getter e devolva `ready`. O descritor `before`, obtido anteriormente, continua a conter `7`.

Lições relacionadas

  • JavaScript · Lição 45 · Avançado · Versão: 4

Fontes