CKTIS / JavaScript
Object.defineProperty: natančen deskriptor lastnosti
Object.defineProperty določi ali spremeni eno lastno lastnost z izrecnim podatkovnim ali dostopnim deskriptorjem.
Različica: ECMAScript 5 onward; example target: Node.js 24.22.2
Sintaksa
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) zahteva dejanski objekt kot obj; primitivnih vrednosti ne ovija. key gre skozi ToPropertyKey in postane niz ali simbol. descriptor se prebere z ToPropertyDescriptor, metoda pa vrne isti ciljni objekt.
Podatkovni deskriptor uporablja value in writable, dostopni pa get in set; mešanje polj obeh vrst sproži TypeError. Pri ustvarjanju nove lastnosti so manjkajoči writable, enumerable in configurable false, manjkajoči value, get in set pa pomenijo undefined; pri spreminjanju obstoječe lastnosti izpuščena polja pustijo njene trenutne atribute nespremenjene. Getter ali setter mora biti klicljiv ali undefined.
Metoda obstaja od ECMAScript 5. DefinePropertyOrThrow sproži TypeError pri dodajanju nove lastnosti nerazširljivemu objektu, če sprememba krši pravila nekonfigurabilne lastnosti ali Proxy prekrši invariante. Združljiva ponovna določitev obstoječe lastnosti lahko uspe tudi na nerazširljivem objektu. Za razliko od prirejanja nadzira atribute brez klica podedovanega setterja, vendar lahko branje deskriptorja in pasti Proxy izvajajo kodo in sprožijo izjemo.
Primeri
const account = {};
const same = Object.defineProperty(account, "balance", {
value: 10, writable: false, enumerable: true, configurable: false
});
let reads = 0;
Object.defineProperty(account, "label", {
get() { return `#${++reads}`; }, configurable: true
});
console.log(same === account, Object.keys(account).join(","));
console.log(account.balance, account.label, account.label);
const balance = Object.getOwnPropertyDescriptor(account, "balance");
const label = Object.getOwnPropertyDescriptor(account, "label");
console.log(balance.writable, balance.configurable, label.set);
try { Object.defineProperty(account, "balance", { value: 11 }); }
catch (error) { console.log(error.name, account.balance); }
try { Object.defineProperty({}, "x", { value: 1, get() {} }); }
catch (error) { console.log(error.name); }Rezultat
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
Primer določi podatkovno lastnost in getter, pregleda atribute ter preizkusi dva TypeError.