KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen