CKTIS / JavaScript
Reflect.defineProperty — definir propiedades con un resultado booleano
Reflect.defineProperty define o modifica una propiedad propia de un objeto mediante un descriptor. Devuelve true o false, pero no garantiza que la ejecución esté libre de excepciones.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
Reflect.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) define o modifica una propiedad propia de target. La clave se convierte en una cadena o un símbolo, y attributes es un objeto descriptor. El método devuelve true si la operación tiene éxito, o false si las reglas del objeto la rechazan.
Un descriptor de datos usa value y writable; un descriptor de accesor usa get y set. Ambos pueden incluir enumerable y configurable. No se deben mezclar campos de datos con campos de accesor. Al crear una propiedad en un objeto ordinario, los indicadores omitidos tienen el valor predeterminado false, y un valor de datos omitido tiene el valor predeterminado undefined. En un objeto ordinario, los campos omitidos no cambian si se modifica una propiedad existente sin cambiar su tipo. Una propiedad configurable puede pasar de ser una propiedad de datos a ser una propiedad de accesor, o viceversa. Si se omiten enumerable y configurable durante la conversión, conservan sus valores anteriores. Por ejemplo, al convertir una propiedad de datos configurable en una propiedad de accesor indicando solo get, se descartan value y writable, y el campo set omitido toma el valor undefined.
La trampa defineProperty de un Proxy recibe un objeto descriptor en el que los campos omitidos siguen ausentes. Puede crear una propiedad con atributos distintos en el objeto de destino del Proxy, siempre que respete sus invariantes.
A diferencia de Object.defineProperty, que devuelve el objeto y lanza un TypeError si se rechaza la definición, este método devuelve un resultado booleano. Sin embargo, no está libre de excepciones: un target que no sea un objeto, un descriptor no válido o una excepción durante la conversión de la clave pueden interrumpir la llamada. La trampa defineProperty de un Proxy también puede lanzar una excepción.
En un objeto ordinario, añadir una propiedad a un objeto no extensible o realizar un cambio no permitido en una propiedad no configurable devuelve false. En el ejemplo, la segunda definición no puede cambiar id porque writable y configurable son false; su valor sigue siendo 7.
Ejemplos
const item = {};
console.log(Reflect.defineProperty(item, "id", {
value: 7,
enumerable: true,
writable: false,
configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));Resultado
true false 7 id
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.