Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła