CKTIS / JavaScript
Object.getOwnPropertyNames — imena lastnih lastnosti
Object.getOwnPropertyNames(obj) vrne novo polje nizovnih ključev. Pri običajnih objektih zajema nizovne ključe vseh lastnih lastnosti, tudi tistih z atributom enumerable, nastavljenim na false. Ključe tipa Symbol izpusti, pri objektu Proxy pa lahko na seznam vpliva past ownKeys.
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.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) je statična metoda: pokličite jo na Object, ne na pregledovanem objektu. Vrne novo polje, ki vsebuje samo nizovne ključe iz rezultata notranje operacije [[OwnPropertyKeys]], ne da bi preverila deskriptorje lastnosti. Pri običajnih objektih zajema vse lastne nizovne ključe ne glede na atribut enumerable, ne pa ključev podedovanih lastnosti. Metoda vrne ključe, ne vrednosti lastnosti.
Pri običajnih objektih Object.keys(obj) vključuje samo ključe lastnih lastnosti z nizovnimi ključi in atributom enumerable, nastavljenim na true. Object.getOwnPropertySymbols(obj) vrne lastne ključe tipa Symbol, medtem ko Reflect.ownKeys(obj) vrne tako lastne nizovne ključe kot lastne ključe tipa Symbol, tudi ključe lastnosti z atributom enumerable, nastavljenim na false. To, ali je lastnost lastna, ni odvisno od tega, ali je vključena v naštevanje.
Pri običajnih objektih se imena, ki so indeksi polja, pojavijo najprej v naraščajočem številskem vrstnem redu; preostali nizovni ključi sledijo vrstnemu redu ustvarjanja lastnosti. To ni abecedno razvrščanje. Objekti Proxy lahko prilagodijo seznam in vrstni red prek pasti ownKeys, ob upoštevanju omejitev specifikacije. Če je ciljni objekt razširljiv, lahko past navede nizovni ključ brez pripadajočega deskriptorja lastne lastnosti ali izpusti nizovni ključ nastavljive lastne lastnosti ciljnega objekta.
null in undefined povzročita TypeError; druge primitivne vrednosti se pretvorijo v objekte. Primer prikazuje vrstni red indeksov in vključitev lastnosti hidden, ki ima pri tej uporabi Object.defineProperty atribut enumerable privzeto nastavljen na false. Lastnost inherited in ključ Symbol sta izpuščena.
Primeri
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)));Rezultat
["2","10","label","hidden"] ["2","10","label"]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.