CKTIS / JavaScript
Object.defineProperty: presný deskriptor vlastnosti
Object.defineProperty definuje alebo zmení jednu vlastnú vlastnosť pomocou explicitného dátového či prístupového deskriptora.
Verzia: ECMAScript 5 onward; example target: Node.js 24.22.2
Syntax
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) vyžaduje skutočný objekt ako obj; primitívne hodnoty nebaľuje. key prejde ToPropertyKey, takže sa stane reťazcom alebo symbolom. descriptor sa načíta cez ToPropertyDescriptor a metóda vráti rovnaký cieľový objekt.
Dátový deskriptor používa value a writable, prístupový deskriptor get a set; kombinácia polí oboch druhov vyvolá TypeError. Pri vytvorení novej vlastnosti sú chýbajúce writable, enumerable a configurable false a chýbajúce value, get a set znamenajú undefined; pri zmene existujúcej vlastnosti ponechajú vynechané polia jej súčasné atribúty bez zmeny. Getter a setter musia byť volateľné alebo undefined.
Metóda existuje od ECMAScript 5. DefinePropertyOrThrow vyvolá TypeError pri pridaní novej vlastnosti do nerozšíriteľného objektu, keď zmena poruší pravidlá nekonfigurovateľnej vlastnosti alebo Proxy poruší invarianty. Kompatibilné predefinovanie existujúcej vlastnosti môže uspieť aj na nerozšíriteľnom objekte. Na rozdiel od priradenia riadi atribúty bez vyvolania zdedeného setteru, no čítanie deskriptora a pasce Proxy môžu spustiť kód a vyvolať výnimku.
Príklady
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); }Výsledok
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
Príklad definuje dátovú vlastnosť a getter, skontroluje atribúty a vyvolá dva prípady TypeError.