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