Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori