CKTIS / JavaScript
Object.getOwnPropertyNames — nazwy własnych właściwości
Object.getOwnPropertyNames(obj) zwraca nową tablicę kluczy tekstowych. Dla zwykłego obiektu są to klucze wszystkich własnych właściwości, także niewyliczalnych. Metoda nie zwraca kluczy typu Symbol, a w przypadku Proxy lista może zależeć od pułapki ownKeys.
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.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) jest metodą statyczną: wywołujesz ją na Object, nie na badanym obiekcie. Zwraca nową tablicę zawierającą tylko klucze tekstowe z wyniku wewnętrznej operacji [[OwnPropertyKeys]], bez sprawdzania deskryptorów właściwości. Dla zwykłego obiektu obejmuje to wszystkie własne klucze tekstowe, niezależnie od atrybutu enumerable, ale nie klucze właściwości odziedziczonych. Metoda zwraca klucze, a nie wartości właściwości.
Dla zwykłego obiektu Object.keys(obj) uwzględnia tylko własne właściwości wyliczalne o kluczach tekstowych. Object.getOwnPropertySymbols(obj) zwraca własne klucze typu Symbol, a Reflect.ownKeys(obj) zwraca własne klucze tekstowe i klucze typu Symbol, także właściwości niewyliczalnych. „Własna” i „wyliczalna” to różne cechy.
Dla zwykłych obiektów nazwy będące indeksami tablicowymi pojawiają się najpierw, w rosnącej kolejności liczbowej; pozostałe nazwy tekstowe zachowują kolejność utworzenia właściwości. Nie jest to sortowanie alfabetyczne. Obiekty Proxy mogą dostosować listę i kolejność przez pułapkę ownKeys, z zachowaniem ograniczeń standardu. Jeśli obiekt docelowy jest rozszerzalny, pułapka może podać klucz tekstowy, któremu nie odpowiada deskryptor własnej właściwości, lub pominąć klucz tekstowy konfigurowalnej własnej właściwości obiektu docelowego.
null i undefined powodują TypeError; pozostałe wartości prymitywne są konwertowane do obiektów. Przykład pokazuje sortowanie indeksów oraz uwzględnienie hidden, które domyślnie jest niewyliczalne przy takim użyciu Object.defineProperty. Właściwość inherited i klucz typu Symbol są pomijane.
Przykłady
const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';
console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));Wynik
["2","10","label","hidden"] ["2","10","label"]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.