CKTIS / JavaScript
Object.keys — własne wyliczalne klucze obiektu
Object.keys(obj) zwraca nową tablicę własnych, wyliczalnych kluczy tekstowych obiektu. Pomija właściwości odziedziczone, niewyliczalne i klucze typu Symbol. W przypadku zwykłych obiektów klucze będące indeksami tablicowymi pojawiają się przed pozostałymi kluczami tekstowymi.
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.keys(obj)Object.keys(obj) jest statyczną metodą Object, która zwraca nową tablicę nazw właściwości. Uwzględnia tylko właściwości własne, czyli niepochodzące z prototypu, z atrybutem enumerable: true i kluczem tekstowym. Wynik zawiera ciągi znaków, nawet gdy klucze zapisano jako liczby. Klucze typu Symbol są pomijane.
Dla zwykłych obiektów klucze będące indeksami tablicowymi są uporządkowane rosnąco liczbowo, a pozostałe klucze tekstowe — według kolejności utworzenia właściwości. Nie jest to sortowanie alfabetyczne ani zasada obejmująca każdy tekst przypominający liczbę: "02" nie jest indeksem tablicowym. Obiekty Proxy mogą wpływać na kolejność i wykonywać kod podczas wyliczania.
W przeciwieństwie do for...in, metoda nie uwzględnia odziedziczonych właściwości wyliczalnych. Reflect.ownKeys(obj) obejmuje natomiast także własne właściwości niewyliczalne i klucze typu Symbol. Sama metoda Object.keys nie odczytuje wartości właściwości i nie wywołuje ich getterów; wynikowa tablica nie aktualizuje się po zmianach obiektu.
null i undefined powodują TypeError. Pozostałe wartości prymitywne są konwertowane na obiekty: Object.keys("ab") daje ["0","1"], a Object.keys(42) daje []. To API języka ECMAScript, nie API przeglądarkowe; działanie przykładu w Node.js nie dowodzi zgodności konkretnej przeglądarki.
Przykłady
const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;
console.log(JSON.stringify(Object.keys(item)));Wynik
["2","10","name"]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.