Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Object.keys — vlastiti enumerabilni ključevi objekta

Object.keys(obj) vraća novi niz s vlastitim enumerabilnim ključevima objekta u obliku nizova znakova. Isključuje naslijeđena i neenumerabilna svojstva te ključeve Symbol. Kod običnih objekata ključevi koji su indeksi polja pojavljuju se prije ostalih nizovnih ključeva.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

Object.keys(obj)

Object.keys(obj) statička je metoda objekta Object koja vraća novi niz naziva svojstava. Uključuje samo vlastita svojstva, odnosno ona koja nisu naslijeđena od prototipa, čiji je atribut enumerable postavljen na true i čiji je ključ niz znakova. Rezultat sadrži nizove znakova čak i kada su ključevi zapisani kao brojevi. Ključevi Symbol isključeni su.

Kod običnih objekata ključevi koji su indeksi polja poredani su uzlazno prema brojčanoj vrijednosti, a zatim slijede ostali nizovni ključevi prema redoslijedu stvaranja svojstava. To nije abecedno sortiranje niti pravilo za svaki niz koji izgleda kao broj: "02" nije indeks polja. Objekti Proxy mogu utjecati na redoslijed i izvršavati kod tijekom enumeracije.

Za razliku od for...in, metoda isključuje naslijeđena enumerabilna svojstva. Reflect.ownKeys(obj) obuhvaća i vlastita neenumerabilna svojstva te ključeve Symbol. Sam Object.keys ne čita vrijednosti svojstava niti poziva njihove gettere; vraćeni se niz ne ažurira kada se objekt promijeni.

null i undefined uzrokuju TypeError. Ostale primitivne vrijednosti pretvaraju se u objekte: Object.keys("ab") daje ["0","1"], dok Object.keys(42) daje []. Ovo je API jezika ECMAScript, a ne API preglednika; pokretanje primjera u Node.jsu ne dokazuje kompatibilnost s određenim preglednikom.

Primjeri

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)));

Rezultat

["2","10","name"]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori