Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes