CKTIS / JavaScript
Object.defineProperty: precizan deskriptor svojstva
Object.defineProperty definira ili mijenja jedno vlastito svojstvo izričitim podatkovnim ili pristupnim deskriptorom.
Verzija: ECMAScript 5 onward; example target: Node.js 24.22.2
Sintaksa
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) zahtijeva stvarni objekt kao obj; primitivne vrijednosti ne omata. key prolazi kroz ToPropertyKey i postaje tekst ili simbol. descriptor se čita preko ToPropertyDescriptor, a metoda vraća isti ciljni objekt.
Podatkovni deskriptor koristi value i writable, a pristupni get i set; miješanje polja obje vrste baca TypeError. Pri stvaranju novog svojstva izostavljeni writable, enumerable i configurable postaju false, a izostavljeni value, get i set znače undefined; pri promjeni postojećeg svojstva izostavljena polja ostavljaju njegove trenutačne atribute nepromijenjenima. Getter i setter moraju biti pozivljivi ili undefined.
Metoda postoji od ECMAScript 5. DefinePropertyOrThrow baca TypeError pri dodavanju novog svojstva neproširivom objektu, kada promjena krši pravila nekonfigurabilnog svojstva ili Proxy krši invarijante. Kompatibilna redefinicija postojećeg svojstva može uspjeti i na neproširivom objektu. Za razliku od dodjele upravlja atributima bez pozivanja naslijeđenog settera, ali čitanje deskriptora i Proxy zamke mogu izvršavati kod i bacati iznimke.
Primjeri
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
Primjer definira podatkovno svojstvo i getter, provjerava atribute i iskušava dva TypeError.