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

CKTIS / JavaScript

Object.getOwnPropertySymbols — claves Symbol propias

Object.getOwnPropertySymbols(obj) devuelve un array de claves de tipo Symbol. En los objetos ordinarios, son las claves de las propiedades propias, incluidas las no enumerables. El método excluye las claves de cadena y no recorre 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

Object.getOwnPropertySymbols(obj)

Object.getOwnPropertySymbols(obj) es un método estático de Object que crea un nuevo array con solo las claves de tipo Symbol de la lista que devuelve la operación interna [[OwnPropertyKeys]] del objeto. Devuelve claves, no valores ni descripciones de símbolos. Para leer el valor de una propiedad, usa obj[key].

El método excluye las claves de cadena y no recorre la cadena de prototipos. No comprueba los descriptores de propiedad: un Proxy con un objeto objetivo extensible puede incluir un símbolo en el resultado de su trampa ownKeys aunque el proxy no tenga un descriptor de propiedad propia para ese símbolo.

En los objetos ordinarios, el resultado incluye las claves de las propiedades propias enumerables y no enumerables, y los símbolos aparecen en el orden en que se crearon dichas propiedades. Object.keys(obj) devuelve solo las claves de cadena de las propiedades propias enumerables, Object.getOwnPropertyNames(obj) devuelve todas las claves de cadena propias y Reflect.ownKeys(obj) devuelve ambos tipos de claves propias.

El argumento se convierte en un objeto; null y undefined provocan un TypeError. Los símbolos no proporcionan privacidad: este método permite encontrar esas claves incluso cuando enumerable: false.

En el ejemplo, el resultado contiene visible y hidden, pero no inherited ni name. Las comparaciones comprueban la identidad de los símbolos, y la última línea lee los valores de las propiedades correspondientes.

Ejemplos

const inherited = Symbol('inherited');
const visible = Symbol('visible');
const hidden = Symbol('hidden');

const obj = Object.create({ [inherited]: 10 });
obj.name = 'demo';
obj[visible] = 20;
Object.defineProperty(obj, hidden, {
  value: 30,
  enumerable: false
});

const keys = Object.getOwnPropertySymbols(obj);
console.log(keys.length);
console.log(keys[0] === visible, keys[1] === hidden);
console.log(keys.includes(inherited));
console.log(keys.map(key => obj[key]).join(','));

Resultado

2
true true
false
20,30

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