CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor: examinar una propiedad propia
Reflect.getOwnPropertyDescriptor(target, key) devuelve el descriptor de una propiedad propia o undefined. Permite examinar el valor, los accesores y los atributos de una propiedad sin recorrer la cadena de prototipos.
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.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) describe únicamente una propiedad propia de target, incluso si no es enumerable. Devuelve un objeto descriptor nuevo o undefined si la propiedad no es propia. No busca las propiedades heredadas en la cadena de prototipos; una propiedad propia cuyo valor sea undefined sigue teniendo un descriptor.
Un descriptor de datos contiene value, writable, enumerable y configurable. Un descriptor de acceso contiene get y set en lugar de value y writable; sus valores son funciones o undefined. Examinar el descriptor de un objeto ordinario no invoca su getter. Modificar el descriptor devuelto no redefine por sí mismo la propiedad; para ello se puede usar Object.defineProperty.
target debe ser un objeto; cualquier valor primitivo, incluidos null y undefined, provoca un TypeError. Esto difiere de Object.getOwnPropertyDescriptor, que envuelve los valores primitivos excepto null y undefined. La operación ToPropertyKey convierte key en una clave de propiedad. Si key es un objeto, primero lo convierte en un valor primitivo, por ejemplo, llamando a su método Symbol.toPrimitive. Si el valor primitivo es un símbolo, se conserva como clave; de lo contrario, se convierte en una cadena.
No des por hecho que la operación siempre carece de efectos secundarios: convertir key puede ejecutar código del usuario, y un Proxy puede activar su trampa getOwnPropertyDescriptor. Las excepciones resultantes se propagan a quien realiza la llamada. El ejemplo muestra que se ignora una propiedad heredada y que cambiar descriptor.value no cambia item.score.
Ejemplos
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Resultado
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42El 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.