CKTIS / JavaScript
Object.getOwnPropertyDescriptors — descriptores de propiedades propias
Para un objeto ordinario, Object.getOwnPropertyDescriptors devuelve los descriptores de todas sus propiedades propias, incluidas las no enumerables y las que tienen claves Symbol. Permite inspeccionar atributos o copiar propiedades sin convertir los accesores en valores.
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.getOwnPropertyDescriptors(obj)Object.getOwnPropertyDescriptors(obj) devuelve un nuevo objeto ordinario. El método obtiene de obj la lista de claves de propiedades propias e incluye el descriptor de cada clave de la lista si obj indica que existe. Admite claves de cadena y de tipo Symbol, incluidas las de propiedades no enumerables; excluye las propiedades heredadas.
El descriptor de una propiedad de datos contiene value, writable, enumerable y configurable. Un descriptor de accesor contiene get y set en lugar de value y writable; una función ausente se representa como undefined. Leer los descriptores de un objeto ordinario no ejecuta sus getters. Sin embargo, con un Proxy pueden activarse trampas y producirse excepciones. El resultado también puede quedar incompleto sin que se lance ninguna excepción: la trampa ownKeys puede omitir la clave de una propiedad propia configurable de un objeto objetivo extensible, aunque el proxy siga proporcionando un descriptor de propiedad propia para esa clave. En ese caso, el método omite ese descriptor del resultado.
Para un objeto ordinario, el patrón Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) crea una copia superficial con el mismo prototipo y los mismos atributos de las propiedades propias. A diferencia de Object.assign, conserva los accesores y las propiedades no enumerables. Los objetos anidados siguen compartiéndose; no es una técnica general para clonar objetos que dependen de slots internos, como Map.
null y undefined provocan un TypeError; los demás valores primitivos se convierten en objetos envolventes. El método pertenece a ECMAScript 2017, no a las Web APIs. La compatibilidad en el navegador de destino debe comprobarse por separado: que esté disponible en Node 24 no lo demuestra.
Ejemplos
let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
hidden: { value: 7, enumerable: false },
doubled: {
get() { reads += 1; return this.hidden * 2; },
enumerable: true
}
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);Resultado
0 7 false function 14 1 true
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.