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.