CKTIS / JavaScript
Object.keys — lastni naštevni ključi objekta
Object.keys(obj) vrne novo polje lastnih naštevnih nizovnih ključev objekta. Izključi podedovane in nenaštevne lastnosti ter ključe Symbol. Pri običajnih objektih so ključi, ki so indeksi polja, pred drugimi nizovnimi ključi.
Različica: 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) je statična metoda objekta Object, ki vrne novo polje imen lastnosti. Vključi samo lastne lastnosti, torej tiste, ki niso podedovane od prototipa, katerih atribut enumerable je true in katerih ključ je niz. Rezultat vsebuje nize, tudi če so bili ključi zapisani kot števila. Ključi Symbol so izključeni.
Pri običajnih objektih so ključi, ki so indeksi polja, razvrščeni po naraščajoči številski vrednosti, za njimi pa sledijo drugi nizovni ključi v vrstnem redu ustvarjanja lastnosti. To ni abecedno razvrščanje in ne velja za vsak niz, ki je videti kot število: "02" ni indeks polja. Objekti Proxy lahko vplivajo na vrstni red in med naštevanjem izvajajo kodo.
Za razliko od for...in metoda ne vključuje podedovanih naštevnih lastnosti. Reflect.ownKeys(obj) pa vključuje tudi lastne nenaštevne lastnosti in ključe Symbol. Object.keys sam ne bere vrednosti lastnosti in ne kliče njihovih getterjev; vrnjeno polje se ob spremembi objekta ne posodobi.
null in undefined povzročita TypeError. Druge primitivne vrednosti se pretvorijo v objekte: Object.keys("ab") vrne ["0","1"], medtem ko Object.keys(42) vrne []. To je API jezika ECMAScript, ne API brskalnika; zagon primera v Node.js ne dokazuje združljivosti z določenim brskalnikom.
Primeri
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"]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.