CKTIS / JavaScript
Reflect.defineProperty — definiranje lastnosti z logičnim rezultatom
Reflect.defineProperty z deskriptorjem definira ali spremeni lastno lastnost objekta. Vrne true ali false, vendar ne zagotavlja izvedbe brez izjem.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Reflect.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) definira ali spremeni lastno lastnost objekta target. Ključ se pretvori v niz ali simbol, attributes pa je objekt deskriptorja. Metoda vrne true, če je operacija uspešna, ali false, če jo pravila objekta zavrnejo.
Podatkovni deskriptor uporablja value in writable, deskriptor dostopnika pa get in set. Oba lahko vsebujeta enumerable in configurable. Podatkovnih polj ne smemo kombinirati s polji dostopnika. Pri ustvarjanju lastnosti na običajnem objektu imajo izpuščene zastavice privzeto vrednost false, izpuščena podatkovna vrednost pa privzeto vrednost undefined. Pri običajnem objektu izpuščena polja ostanejo nespremenjena, če se ob spreminjanju obstoječe lastnosti njena vrsta ne spremeni. Konfigurabilno lastnost lahko spremenimo iz podatkovne lastnosti v dostopniško ali obratno. Če pri tem izpustimo enumerable in configurable, ti polji ohranita prejšnji vrednosti. Če na primer konfigurabilno podatkovno lastnost spremenimo v dostopniško tako, da navedemo le get, se polji value in writable odstranita, izpuščeno polje set pa dobi vrednost undefined.
Past defineProperty objekta Proxy prejme objekt deskriptorja, v katerem izpuščena polja še vedno manjkajo. Na ciljnem objektu lahko ustvari lastnost z drugačnimi atributi, če pri tem ne krši invariant objekta Proxy.
Za razliko od Object.defineProperty, ki vrne objekt in ob zavrnitvi definicije sproži TypeError, ta metoda vrne logični rezultat. Vendar ni brez izjem: klic lahko prekine target, ki ni objekt, neveljaven deskriptor ali izjema med pretvorbo ključa. Izjemo lahko sproži tudi past defineProperty objekta Proxy.
Pri običajnem objektu dodajanje lastnosti nerazširljivemu objektu ali nedovoljena sprememba nekonfigurabilne lastnosti vrne false. V primeru druga definicija ne more spremeniti id, ker sta writable in configurable nastavljena na false; vrednost ostane 7.
Primeri
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(","));Rezultat
true false 7 id
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.