Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri