Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

PropertyDescriptor.value — hodnota datové vlastnosti

Pole `value` obsahuje uloženou hodnotu datové vlastnosti. Vynechat ho ve vstupním deskriptoru není totéž jako výslovně zadat `value: undefined`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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 označuje pole value objektu, který popisuje datovou vlastnost, nikoli vlastnost globálního konstruktoru. Odpovídá poli [[Value]] ve specifikaci a může obsahovat libovolnou hodnotu JavaScriptu, včetně objektu, funkce nebo undefined. Pole writable určuje, zda lze hodnotu nahradit přiřazením; uložený objekt nezmrazí.

U běžného objektu použije Object.defineProperty() výchozí hodnotu undefined, pokud vytvoří datovou vlastnost bez pole value. Při úpravě existující datové vlastnosti beze změny jejího druhu vynechání value zachová původní hodnotu, zatímco value: undefined požaduje její nahrazení. Pokud existující datová vlastnost není konfigurovatelná ani zapisovatelná, zadání jiné hodnoty podle SameValue (porovnání používaného metodou Object.is) vyvolá TypeError.

Přístupový deskriptor používá get a set namísto value a writable. Ve vstupním deskriptoru nelze kombinovat pole z obou skupin: i { value: undefined, get: undefined } vyvolá TypeError. Započítávají se také zděděná pole vstupního deskriptoru.

Object.getOwnPropertyDescriptor() vrátí undefined, pokud pro daný klíč neexistuje vlastní vlastnost. Pokud vrátí deskriptor, Object.hasOwn(descriptor, "value") rozliší datovou vlastnost s hodnotou undefined od přístupové vlastnosti. Deskriptor není živým pohledem na vlastnost: změna descriptor.value nenahradí hodnotu v cílovém objektu. Pokud je uloženou hodnotou objekt, deskriptor odkazuje na tentýž objekt, ne na jeho kopii.

Příklady

{
  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));
}

Výsledek

7
true: undefined
false: ready
7

Vynechání `value` zachová `7`; výslovné `value: undefined` hodnotu nahradí. Deskriptor vlastnosti `label` nemá vlastní pole `value`, přestože čtení `target.label` zavolá getter a vrátí `ready`. Dříve získaný deskriptor `before` stále obsahuje `7`.

Související lekce

  • JavaScript · Lekce 45 · Pokročilá · Verze: 4

Zdroje