WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.defineProperties: mehrere Deskriptoren zugleich

Object.defineProperties definiert mehrere Eigenschaften mit vollständigen Deskriptoren, nachdem die gesamte Deskriptorkarte gesammelt und geprüft wurde.

Version: ECMAScript 5 onward; example target: Node.js 24.22.2

Syntax

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) verlangt für obj ein Objekt und verpackt primitive Werte nicht. properties durchläuft ToObject; daher werfen null und undefined einen TypeError. Die Methode nimmt eine Momentaufnahme der eigenen String- und Symbolschlüssel der Karte und berücksichtigt nur jene, deren aktueller eigener Deskriptor aufzählbar ist.

Zuerst liest sie jeden ausgewählten Wert und wandelt ihn mit ToPropertyDescriptor um. Erst wenn alle Deskriptoren erfolgreich gesammelt sind, beginnt sie Eigenschaften am Ziel zu definieren. Ein ungültiger Deskriptor oder werfender Getter in dieser ersten Phase lässt das Ziel somit unverändert. Die Definitionsphase ist jedoch sequenziell, nicht transaktional: Scheitert eine spätere Definition, können frühere bestehen bleiben.

Die Methode gibt dasselbe obj zurück und existiert seit ECMAScript 5. Beim Erstellen einer neuen Eigenschaft werden fehlende writable, enumerable und configurable zu false, fehlende value, get und set zu undefined; beim Ändern einer bestehenden Eigenschaft bleiben fehlende Felder unverändert. value/writable dürfen nicht mit get/set gemischt werden, und Accessoren müssen aufrufbar oder undefined sein. Getter und Proxy-Fallen der Karte oder des Ziels können Code ausführen und werfen.

Beispiele

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); }

Ergebnis

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

Das Beispiel zeigt Symbole, restriktive Standardwerte, Vorabprüfung und eine teilweise Änderung beim Definieren.

Quellen