CKTIS / JavaScript
Object.defineProperties : plusieurs descripteurs à la fois
Object.defineProperties définit plusieurs propriétés avec leurs descripteurs complets après avoir collecté et validé toute la table.
Version : ECMAScript 5 onward; example target: Node.js 24.22.2
Syntaxe
Object.defineProperties(obj, properties)Object.defineProperties(obj, properties) exige que obj soit un objet et n’encapsule pas les primitives. properties subit ToObject : null et undefined lèvent donc TypeError. La méthode prend un instantané des clés propres, chaînes et symboles, puis ne retient que celles dont le descripteur propre courant est énumérable.
Elle lit d’abord chaque valeur retenue et la convertit avec ToPropertyDescriptor ; elle ne commence à définir les propriétés de la cible qu’après la collecte réussie de tous les descripteurs. Un descripteur invalide ou un getter qui lève durant cette phase laisse donc la cible intacte. La définition reste séquentielle, non transactionnelle : si une définition tardive échoue, les précédentes peuvent subsister.
La méthode renvoie le même obj et existe depuis ECMAScript 5. Lors de la création d’une propriété, les champs omis writable, enumerable et configurable deviennent false, et value, get et set deviennent undefined ; lors de la modification d’une propriété existante, les champs omis restent inchangés. On ne peut mêler value/writable à get/set, et un accesseur doit être appelable ou undefined. Getters et pièges Proxy de la table ou de la cible peuvent exécuter du code et lever une exception.
Exemples
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); }Résultat
visible,doubled 6 ok false TypeError false TypeError 2 1
L’exemple montre les symboles, les valeurs restrictives, la validation préalable et une modification partielle.