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

CKTIS / JavaScript

Object.getOwnPropertyNames — nombres de propiedades propias

Object.getOwnPropertyNames(obj) devuelve en un nuevo array claves de tipo cadena. Para un objeto ordinario, son las claves de todas las propiedades propias que tienen ese tipo de clave, incluidas las no enumerables. Se excluyen las claves Symbol, y la trampa ownKeys de un Proxy puede afectar a la lista.

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.getOwnPropertyNames(obj)

Object.getOwnPropertyNames(obj) es un método estático: llámalo sobre Object, no sobre el objeto inspeccionado. Devuelve un nuevo array que contiene solo las claves de tipo cadena del resultado de la operación interna [[OwnPropertyKeys]], sin comprobar los descriptores de propiedad. En los objetos ordinarios, incluye todas las claves de tipo cadena de las propiedades propias, con independencia del atributo enumerable, pero no las de las propiedades heredadas. El método devuelve claves, no valores de propiedades.

En los objetos ordinarios, Object.keys(obj) solo incluye propiedades propias enumerables cuyas claves son cadenas. Object.getOwnPropertySymbols(obj) devuelve las claves Symbol de las propiedades propias, mientras que Reflect.ownKeys(obj) devuelve tanto las claves de tipo cadena como las de tipo Symbol de las propiedades propias, incluidas las no enumerables. «Propia» y «enumerable» describen características distintas.

En los objetos ordinarios, los nombres que son índices de array aparecen primero, en orden numérico ascendente; las demás claves de tipo cadena siguen el orden de creación de las propiedades. No se trata de un orden alfabético. Los objetos Proxy pueden personalizar la lista y su orden mediante la trampa ownKeys, dentro de los límites de la especificación. Si el objeto objetivo es extensible, la trampa puede indicar una clave de tipo cadena sin descriptor de propiedad propia correspondiente u omitir la clave de tipo cadena de una propiedad propia configurable del objeto objetivo.

null y undefined provocan un TypeError; los demás valores primitivos se convierten en objetos. El ejemplo muestra el orden de los índices y la inclusión de hidden, que con este uso de Object.defineProperty no es enumerable de forma predeterminada. Se excluyen la propiedad inherited y la clave Symbol.

Ejemplos

const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';

console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));

Resultado

["2","10","label","hidden"]
["2","10","label"]

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