CKTIS / JavaScript
Object.getOwnPropertySymbols — własne klucze symbolowe
Object.getOwnPropertySymbols(obj) zwraca tablicę kluczy typu Symbol. Dla zwykłych obiektów są to klucze własnych właściwości, również niewyliczalnych. Metoda pomija klucze tekstowe i nie przeszukuje łańcucha prototypów.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) to statyczna metoda Object, która tworzy nową tablicę zawierającą tylko klucze typu Symbol z listy zwróconej przez wewnętrzną operację [[OwnPropertyKeys]] obiektu. Zwraca klucze, a nie wartości ani opisy symboli. Wartość właściwości odczytasz przez obj[key].
Metoda pomija klucze tekstowe i nie przeszukuje łańcucha prototypów. Nie sprawdza deskryptorów właściwości: Proxy z rozszerzalnym obiektem docelowym może przez pułapkę ownKeys zgłosić symbol, dla którego sam Proxy nie ma deskryptora własnej właściwości.
Dla zwykłych obiektów wynik obejmuje klucze własnych właściwości wyliczalnych i niewyliczalnych, a symbole występują w kolejności utworzenia tych właściwości. Object.keys(obj) zwraca tylko wyliczalne własne klucze tekstowe, Object.getOwnPropertyNames(obj) wszystkie własne klucze tekstowe, a Reflect.ownKeys(obj) oba rodzaje własnych kluczy.
Argument jest przekształcany w obiekt; null i undefined powodują TypeError. Symbole nie zapewniają prywatności: ta metoda pozwala odnaleźć takie klucze nawet przy enumerable: false.
W przykładzie wynik zawiera visible i hidden, ale nie inherited ani name. Porównania sprawdzają tożsamość symboli, a ostatnia linia odczytuje wartości odpowiadających im właściwości.
Przykłady
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(','));Wynik
2 true true false 20,30
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.