CKTIS / JavaScript
Object.defineProperty : descripteur précis d’une propriété
Object.defineProperty définit ou modifie une propriété propre au moyen d’un descripteur de données ou d’accesseur explicite.
Version : ECMAScript 5 onward; example target: Node.js 24.22.2
Syntaxe
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) exige un véritable objet pour obj et n’encapsule pas les primitives. key subit ToPropertyKey et devient donc une chaîne ou un symbole. descriptor est lu par ToPropertyDescriptor, puis la méthode renvoie le même objet cible.
Un descripteur de données emploie value et writable, tandis qu’un descripteur d’accesseur emploie get et set ; mélanger les deux catégories lève TypeError. Lors de la création d’une propriété, les champs absents writable, enumerable et configurable valent false, et les absences de value, get et set signifient undefined ; lors de la modification d’une propriété existante, les champs omis laissent ses attributs courants inchangés. Getter et setter doivent être appelables ou undefined.
La méthode existe depuis ECMAScript 5. DefinePropertyOrThrow lève TypeError lors de l’ajout d’une nouvelle propriété à un objet non extensible, si le changement enfreint les règles d’une propriété non configurable ou si un Proxy viole les invariants. Une redéfinition compatible d’une propriété existante peut réussir même sur un objet non extensible. Contrairement à l’affectation, elle contrôle les attributs sans appeler un setter hérité, mais la lecture du descripteur et les pièges Proxy peuvent exécuter du code et lever une exception.
Exemples
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); }Résultat
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
L’exemple définit une donnée et un getter, inspecte les attributs et montre deux cas TypeError.