Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła