CKTIS / JavaScript
Object.getOwnPropertySymbols — vlastiti simbolni ključevi
Object.getOwnPropertySymbols(obj) vraća polje ključeva tipa Symbol. Kod običnih objekata to su ključevi vlastitih svojstava, uključujući ona s atributom `enumerable: false`. Metoda izostavlja tekstualne ključeve i ne prolazi lancem prototipova.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) statička je metoda objekta Object koja stvara novo polje samo s ključevima tipa Symbol s popisa koji vraća interna operacija objekta [[OwnPropertyKeys]]. Vraća ključeve, a ne vrijednosti ili opise simbola. Vrijednost svojstva pročitajte pomoću obj[key].
Metoda izostavlja tekstualne ključeve i ne prolazi lancem prototipova. Ne provjerava deskriptore svojstava: Proxy s proširivim ciljnim objektom može preko presretača ownKeys navesti simbol čak i ako za taj simbol nema deskriptor vlastitog svojstva.
Kod običnih objekata rezultat uključuje ključeve vlastitih svojstava neovisno o vrijednosti atributa enumerable, a simboli se pojavljuju redoslijedom stvaranja tih svojstava. Object.keys(obj) vraća samo tekstualne ključeve vlastitih svojstava s enumerable: true, Object.getOwnPropertyNames(obj) vraća sve vlastite tekstualne ključeve, a Reflect.ownKeys(obj) vraća obje vrste vlastitih ključeva.
Argument se pretvara u objekt; null i undefined uzrokuju TypeError. Simboli ne pružaju privatnost: ova metoda može pronaći te ključeve čak i kada vrijedi enumerable: false.
U primjeru rezultat sadrži visible i hidden, ali ne i inherited ni name. Usporedbe provjeravaju istovjetnost simbola, a posljednji redak čita vrijednosti odgovarajućih svojstava.
Primjeri
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(','));Rezultat
2 true true false 20,30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.