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

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.

Fuentes