CKTIS / JavaScript
Object.defineProperty: een precieze eigenschapsdescriptor
Object.defineProperty definieert of wijzigt één eigen eigenschap met een expliciete data- of accessordescriptor.
Versie: ECMAScript 5 onward; example target: Node.js 24.22.2
Syntax
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) vereist een werkelijk object als obj; primitieve waarden worden niet geboxed. key ondergaat ToPropertyKey en wordt dus een string of symbool. descriptor wordt door ToPropertyDescriptor gelezen en de methode retourneert hetzelfde doelobject.
Een datadescriptor gebruikt value en writable, een accessordescriptor get en set; velden van beide soorten mengen werpt TypeError. Bij het maken van een nieuwe eigenschap worden ontbrekende writable, enumerable en configurable false, terwijl ontbrekende value, get en set undefined betekenen; bij het bijwerken van een bestaande eigenschap laten weggelaten velden de huidige attributen ongewijzigd. Een getter of setter moet aanroepbaar of undefined zijn.
De methode bestaat sinds ECMAScript 5. DefinePropertyOrThrow werpt TypeError bij het toevoegen van een nieuwe eigenschap aan een niet-uitbreidbaar object, wanneer een wijziging de regels van een niet-configureerbare eigenschap schendt of wanneer een Proxy invarianten breekt. Een compatibele herdefinitie van een bestaande eigenschap kan op een niet-uitbreidbaar object wel slagen. Anders dan toewijzing beheert zij attributen zonder een geërfde setter aan te roepen, al kunnen descriptorvelden en Proxy-traps code uitvoeren en werpen.
Voorbeelden
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); }Resultaat
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
Het voorbeeld definieert een data-eigenschap en getter, inspecteert attributen en test twee TypeErrors.