CKTIS / JavaScript
PropertyDescriptor.value — hodnota dátovej vlastnosti
Pole `value` obsahuje uloženú hodnotu dátovej vlastnosti. Vynechať ho vo vstupnom deskriptore nie je to isté ako výslovne uviesť `value: undefined`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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, ktorý opisuje dátovú vlastnosť, nie vlastnosť globálneho konštruktora. Zodpovedá poľu [[Value]] v špecifikácii a môže obsahovať ľubovoľnú hodnotu JavaScriptu vrátane objektu, funkcie alebo undefined. Pole writable určuje, či sa dá hodnota nahradiť priradením; uložený objekt nezmrazí.
Pri bežnom objekte použije Object.defineProperty() predvolenú hodnotu undefined, ak vytvára dátovú vlastnosť bez poľa value. Pri úprave existujúcej dátovej vlastnosti bez zmeny jej typu vynechanie value zachová pôvodnú hodnotu, zatiaľ čo value: undefined žiada jej nahradenie. Ak existujúca dátová vlastnosť nie je konfigurovateľná ani zapisovateľná, zadanie inej hodnoty podľa SameValue (porovnania používaného metódou Object.is) vyvolá TypeError.
Prístupový deskriptor používa get a set namiesto value a writable. Vo vstupnom deskriptore nemožno kombinovať polia z oboch skupín: aj { value: undefined, get: undefined } vyvolá TypeError. Zohľadňujú sa aj zdedené polia vstupného deskriptora.
Object.getOwnPropertyDescriptor() vráti undefined, ak pre daný kľúč neexistuje vlastná vlastnosť. Ak vráti deskriptor, Object.hasOwn(descriptor, "value") odlíši dátovú vlastnosť s hodnotou undefined od prístupovej vlastnosti. Deskriptor nie je živým pohľadom na vlastnosť: zmena descriptor.value nenahradí hodnotu v cieľovom objekte. Ak je uloženou hodnotou objekt, deskriptor odkazuje na ten istý objekt, nie na jeho kópiu.
Prí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ýsledok
7 true: undefined false: ready 7
Vynechanie `value` zachová `7`; výslovné `value: undefined` hodnotu nahradí. Deskriptor vlastnosti `label` nemá vlastné pole `value`, hoci čítanie `target.label` zavolá getter a vráti `ready`. Skôr získaný deskriptor `before` stále obsahuje `7`.
Súvisiace lekcie
- JavaScript · Lekcia 45 · Pokročilá · Verzia: 4