CKTIS / JavaScript
Reflect.defineProperty — definovanie vlastností s logickým výsledkom
Reflect.defineProperty definuje alebo mení vlastnú vlastnosť objektu pomocou deskriptora. Vráti true alebo false, ale nezaručuje vykonanie bez výnimiek.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) definuje alebo mení vlastnú vlastnosť objektu target. Kľúč sa prevedie na reťazec alebo symbol a attributes je objekt deskriptora. Metóda vráti true, ak sa operácia podarí, alebo false, ak ju pravidlá objektu odmietnu.
Dátový deskriptor používa value a writable; prístupový deskriptor používa get a set. Oba môžu obsahovať enumerable a configurable. Dátové polia sa nesmú kombinovať s prístupovými poľami. Pri vytváraní vlastnosti na bežnom objekte majú vynechané príznaky predvolenú hodnotu false a vynechaná dátová hodnota má predvolenú hodnotu undefined. Pri bežnom objekte zostávajú vynechané polia nezmenené, ak sa pri úprave existujúcej vlastnosti nemení jej druh. Konfigurovateľná vlastnosť sa môže zmeniť z dátovej na prístupovú alebo naopak. Ak sa pri tejto zmene vynechajú enumerable a configurable, zachovajú si pôvodné hodnoty. Ak napríklad zmeníte konfigurovateľnú dátovú vlastnosť na prístupovú uvedením iba get, polia value a writable sa odstránia a vynechané pole set sa nastaví na undefined.
Pasca defineProperty objektu Proxy dostane objekt deskriptora, v ktorom vynechané polia naďalej chýbajú. Na cieľovom objekte Proxy môže vytvoriť vlastnosť s inými atribútmi, pokiaľ neporuší invarianty Proxy.
Na rozdiel od Object.defineProperty, ktorá vracia objekt a pri odmietnutí definície vyvolá TypeError, táto metóda vracia logický výsledok. Nie je však bez výnimiek: volanie môže prerušiť target, ktorý nie je objektom, neplatný deskriptor alebo výnimka pri prevode kľúča. Výnimku môže vyvolať aj pasca defineProperty objektu Proxy.
Pri bežnom objekte vráti pridanie vlastnosti do nerozšíriteľného objektu alebo nepovolená zmena nekonfigurovateľnej vlastnosti false. V príklade druhá definícia nemôže zmeniť id, pretože writable a configurable majú hodnotu false; hodnota zostane 7.
Príklady
const item = {};
console.log(Reflect.defineProperty(item, "id", {
value: 7,
enumerable: true,
writable: false,
configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));Výsledok
true false 7 id
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.