CKTIS / JavaScript
Object.getOwnPropertySymbols — lastni simbolni ključi
Object.getOwnPropertySymbols(obj) vrne polje ključev tipa Symbol. Pri običajnih objektih so to ključi lastnih lastnosti, tudi tistih z atributom `enumerable: false`. Metoda izpusti besedilne ključe in ne preišče verige prototipov.
Različica: 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) je statična metoda objekta Object, ki ustvari novo polje samo s ključi tipa Symbol s seznama, ki ga vrne notranja operacija objekta [[OwnPropertyKeys]]. Vrne ključe, ne vrednosti ali opisov simbolov. Vrednost lastnosti preberete z obj[key].
Metoda izpusti besedilne ključe in ne preišče verige prototipov. Ne preverja deskriptorjev lastnosti: Proxy z razširljivim ciljnim objektom lahko prek prestreznika ownKeys navede simbol, tudi če zanj nima deskriptorja lastne lastnosti.
Pri običajnih objektih rezultat vključuje ključe lastnih lastnosti ne glede na vrednost atributa enumerable, simboli pa se pojavijo v vrstnem redu, v katerem so bile te lastnosti ustvarjene. Object.keys(obj) vrne samo besedilne ključe lastnih lastnosti z enumerable: true, Object.getOwnPropertyNames(obj) vrne vse lastne besedilne ključe, Reflect.ownKeys(obj) pa vrne obe vrsti lastnih ključev.
Argument se pretvori v objekt; null in undefined povzročita TypeError. Simboli ne zagotavljajo zasebnosti: ta metoda lahko odkrije te ključe tudi, kadar velja enumerable: false.
V primeru rezultat vsebuje visible in hidden, ne pa inherited ali name. Primerjave preverjajo istovetnost simbolov, zadnja vrstica pa prebere vrednosti ustreznih lastnosti.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.