CKTIS / JavaScript
Object.getOwnPropertySymbols — vlastní symbolové klíče
Object.getOwnPropertySymbols(obj) vrací pole klíčů typu Symbol. U běžných objektů jde o klíče vlastních vlastností, včetně těch s atributem `enumerable: false`. Metoda vynechává řetězcové klíče a neprochází řetězec prototypů.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) je statická metoda objektu Object, která vytvoří nové pole obsahující pouze klíče typu Symbol ze seznamu vráceného interní operací [[OwnPropertyKeys]] daného objektu. Vrací klíče, nikoli hodnoty nebo popisy symbolů. Hodnotu vlastnosti přečtete pomocí obj[key].
Metoda vynechává řetězcové klíče a neprochází řetězec prototypů. Nekontroluje deskriptory vlastností: Proxy s rozšiřitelným cílovým objektem může prostřednictvím pasti ownKeys uvést symbol, i když pro něj sám nemá deskriptor vlastní vlastnosti.
U běžných objektů výsledek zahrnuje klíče vlastních vlastností bez ohledu na hodnotu atributu enumerable. Symboly se objevují v pořadí, v jakém byly tyto vlastnosti vytvořeny. Object.keys(obj) vrací pouze řetězcové klíče vlastních vlastností s enumerable: true, Object.getOwnPropertyNames(obj) vrací všechny vlastní řetězcové klíče a Reflect.ownKeys(obj) vrací oba druhy vlastních klíčů.
Argument se převede na objekt; null a undefined způsobí TypeError. Symboly nezajišťují soukromí: tato metoda dokáže takové klíče najít, i když platí enumerable: false.
V příkladu výsledek obsahuje visible a hidden, ale neobsahuje inherited ani name. Porovnání ověřují totožnost symbolů a poslední řádek čte hodnoty odpovídajících vlastností.
Pří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ýsledek
2 true true false 20,30
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.