CKTIS / JavaScript
Object.getOwnPropertyDescriptor — inspeccionar una propiedad propia
Object.getOwnPropertyDescriptor devuelve una descripción de una propiedad propia del objeto: su valor o sus accesores, junto con las marcas de sus atributos. No recorre la cadena de prototipos y devuelve undefined si el objeto no tiene esa propiedad propia.
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
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) lee el descriptor de una única propiedad propia, incluso si no es enumerable. No busca en los prototipos. El resultado es un nuevo objeto descriptor, o undefined si la propiedad no está directamente en obj. Una propiedad existente cuyo valor sea undefined sigue teniendo un descriptor.
Un descriptor de una propiedad de datos contiene value, writable, enumerable y configurable. Un descriptor de una propiedad accesora contiene get y set en lugar de value y writable; un accesor que falta tiene el valor undefined. En un objeto ordinario, leer el descriptor no invoca el getter. writable determina si una asignación puede cambiar el valor, enumerable si se incluye al enumerar y configurable si la propiedad puede eliminarse o reconfigurarse.
Cambiar los campos del objeto devuelto no cambia la propiedad original. Para aplicar un descriptor, usa Object.defineProperty, teniendo en cuenta las restricciones de la propiedad existente. El descriptor no es una copia profunda: un objeto almacenado en value sigue siendo la misma referencia.
key se convierte en una clave de propiedad: una cadena o un símbolo. Pasar null o undefined como obj provoca un TypeError; los demás valores primitivos se envuelven en objetos. En un Proxy, la operación puede invocar la trampa getOwnPropertyDescriptor, por lo que puede tener efectos secundarios o lanzar una excepción.
Ejemplos
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Resultado
42 false true true 42 undefined
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.