Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.getOwnPropertySymbols — vlastné symbolové kľúče

Object.getOwnPropertySymbols(obj) vracia pole kľúčov typu Symbol. Pri bežných objektoch ide o kľúče vlastných vlastností vrátane nevymenovateľných. Metóda vynecháva reťazcové kľúče a neprechádza reťazec prototypov.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.getOwnPropertySymbols(obj)

Object.getOwnPropertySymbols(obj) je statická metóda objektu Object, ktorá vytvorí nové pole obsahujúce iba kľúče typu Symbol zo zoznamu vráteného internou operáciou [[OwnPropertyKeys]] objektu. Vracia kľúče, nie hodnoty ani opisy symbolov. Hodnotu vlastnosti prečítate pomocou obj[key].

Metóda vynecháva reťazcové kľúče a neprechádza reťazec prototypov. Nekontroluje deskriptory vlastností: Proxy s rozšíriteľným cieľovým objektom môže prostredníctvom pasce ownKeys uviesť symbol, aj keď preň sám nemá deskriptor vlastnej vlastnosti.

Pri bežných objektoch výsledok zahŕňa kľúče vymenovateľných aj nevymenovateľných vlastných vlastností a symboly sú zoradené podľa poradia vytvorenia týchto vlastností. Object.keys(obj) vracia iba reťazcové kľúče vymenovateľných vlastných vlastností, Object.getOwnPropertyNames(obj) vracia všetky vlastné reťazcové kľúče a Reflect.ownKeys(obj) vracia oba druhy vlastných kľúčov.

Argument sa prevedie na objekt; null a undefined spôsobia TypeError. Symboly neposkytujú súkromie: táto metóda dokáže takéto kľúče nájsť aj vtedy, keď platí enumerable: false.

V príklade výsledok obsahuje visible a hidden, ale neobsahuje inherited ani name. Porovnania overujú totožnosť symbolov a posledný riadok číta hodnoty zodpovedajúcich vlastností.

Príklady

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(','));

Výsledok

2
true true
false
20,30

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje