CKTIS / JavaScript
Object.getOwnPropertySymbols — chaves Symbol próprias
Object.getOwnPropertySymbols(obj) devolve um array de chaves do tipo Symbol. Nos objetos comuns, são as chaves das propriedades próprias, incluindo as não enumeráveis. O método exclui as chaves do tipo cadeia de caracteres e não percorre a cadeia de protótipos.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) é um método estático de Object que cria um novo array apenas com as chaves do tipo Symbol da lista devolvida pela operação interna [[OwnPropertyKeys]] do objeto. Devolve chaves, não valores nem descrições de símbolos. Para ler o valor de uma propriedade, utiliza obj[key].
O método exclui as chaves do tipo cadeia de caracteres e não percorre a cadeia de protótipos. Não verifica os descritores de propriedades: um Proxy com um objeto-alvo extensível pode indicar um símbolo através do seu intercetor ownKeys, mesmo que o proxy não tenha um descritor de propriedade própria para esse símbolo.
Nos objetos comuns, o resultado inclui as chaves das propriedades próprias enumeráveis e não enumeráveis, e os símbolos surgem pela ordem de criação dessas propriedades. Object.keys(obj) devolve apenas as chaves do tipo cadeia de caracteres das propriedades próprias enumeráveis, Object.getOwnPropertyNames(obj) devolve todas as chaves próprias desse tipo e Reflect.ownKeys(obj) devolve ambos os tipos de chaves próprias.
O argumento é convertido num objeto; null e undefined provocam um TypeError. Os símbolos não garantem privacidade: este método permite encontrar essas chaves mesmo quando enumerable: false.
No exemplo, o resultado contém visible e hidden, mas não contém inherited nem name. As comparações verificam a identidade dos símbolos, e a última linha lê os valores das propriedades correspondentes.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.