Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje