CKTIS / JavaScript
Object.defineProperty: descriptor preciso de una propiedad
Object.defineProperty define o cambia una propiedad propia mediante un descriptor explícito de datos o de acceso.
Versión: ECMAScript 5 onward; example target: Node.js 24.22.2
Sintaxis
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) exige un objeto real como obj; no envuelve primitivas. key pasa por ToPropertyKey, así que se convierte en texto o símbolo. descriptor se lee mediante ToPropertyDescriptor y el método devuelve el mismo objeto destino.
Un descriptor de datos usa value y writable, mientras uno de acceso usa get y set; mezclar campos de ambos tipos lanza TypeError. Al crear una propiedad nueva, writable, enumerable y configurable ausentes son false, y value, get y set ausentes significan undefined; al actualizar una propiedad existente, los campos omitidos dejan intactos sus atributos actuales. Getter y setter deben ser invocables o undefined.
El método existe desde ECMAScript 5. DefinePropertyOrThrow lanza TypeError al añadir una propiedad nueva a un objeto no extensible, si el cambio viola las reglas de una propiedad no configurable o si un Proxy rompe invariantes. Una redefinición compatible de una propiedad existente aún puede tener éxito en un objeto no extensible. A diferencia de una asignación, controla atributos sin invocar un setter heredado, aunque leer el descriptor y las trampas Proxy puede ejecutar código y lanzar.
Ejemplos
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); }Resultado
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
El ejemplo define una propiedad de datos y un getter, inspecciona atributos y prueba dos TypeError.