CKTIS / JavaScript
Object.defineProperties: meerdere descriptors tegelijk
Object.defineProperties definieert meerdere eigenschappen met volledige descriptors nadat de hele descriptorkaart is verzameld en gevalideerd.
Versie: ECMAScript 5 onward; example target: Node.js 24.22.2
Syntax
Object.defineProperties(obj, properties)Object.defineProperties(obj, properties) vereist dat obj een object is en boxt primitieve waarden niet. properties ondergaat ToObject, zodat null en undefined een TypeError werpen. De methode maakt een momentopname van de eigen string- en symboolsleutels en gebruikt alleen sleutels waarvan de huidige eigen descriptor opsombaar is.
Eerst haalt zij elke geselecteerde waarde op en zet die om met ToPropertyDescriptor; pas nadat alle descriptors succesvol zijn verzameld, begint zij eigenschappen op het doel te definiëren. Een ongeldige descriptor of werpende getter in deze eerste fase laat het doel dus ongewijzigd. De definitiefase is wel sequentieel, niet transactioneel: als een latere definitie mislukt, kunnen eerdere blijven bestaan.
De methode retourneert hetzelfde obj en bestaat sinds ECMAScript 5. Bij het maken van een nieuwe eigenschap worden weggelaten writable, enumerable en configurable false, terwijl weggelaten value, get en set undefined worden; bij het bijwerken van een bestaande eigenschap blijven weggelaten velden ongewijzigd. value/writable mogen niet met get/set worden gemengd, en een accessor moet aanroepbaar of undefined zijn. Getters en Proxy-traps op kaart of doel kunnen code uitvoeren en uitzonderingen werpen.
Voorbeelden
const token = Symbol("token");
const target = {};
Object.defineProperties(target, {
visible: { value: 3, enumerable: true },
doubled: { get() { return this.visible * 2; }, enumerable: true },
[token]: { value: "ok" }
});
console.log(Object.keys(target).join(","), target.doubled, target[token]);
console.log(Object.getOwnPropertyDescriptor(target, "visible").writable);
const untouched = {};
try {
Object.defineProperties(untouched, {
first: { value: 1 },
bad: { get: 1 }
});
} catch (error) { console.log(error.name, Object.hasOwn(untouched, "first")); }
const partial = {};
Object.defineProperty(partial, "locked", { value: 1 });
try {
Object.defineProperties(partial, {
added: { value: 2 },
locked: { value: 3 }
});
} catch (error) { console.log(error.name, partial.added, partial.locked); }Resultaat
visible,doubled 6 ok false TypeError false TypeError 2 1
Het voorbeeld toont symbolen, restrictieve defaults, voorafgaande validatie en een gedeeltelijke wijziging.