CKTIS / JavaScript
Object.getOwnPropertyNames — názvy vlastných vlastností
Object.getOwnPropertyNames(obj) vracia nové pole reťazcových kľúčov. Pri obyčajných objektoch zahŕňa reťazcové kľúče všetkých vlastných vlastností vrátane nevymenovateľných. Kľúče typu Symbol sa vynechávajú a pri objekte Proxy môže zoznam ovplyvniť pasca ownKeys.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) je statická metóda: volajte ju na Object, nie na skúmanom objekte. Vracia nové pole obsahujúce iba reťazcové kľúče z výsledku internej operácie [[OwnPropertyKeys]] bez kontroly deskriptorov vlastností. Pri obyčajných objektoch zahŕňa všetky vlastné reťazcové kľúče bez ohľadu na atribút enumerable, ale nie kľúče zdedených vlastností. Metóda vracia kľúče, nie hodnoty vlastností.
Pri obyčajných objektoch zahŕňa Object.keys(obj) iba vymenovateľné vlastné vlastnosti s reťazcovými kľúčmi. Object.getOwnPropertySymbols(obj) vracia vlastné kľúče typu Symbol, zatiaľ čo Reflect.ownKeys(obj) vracia vlastné reťazcové kľúče aj vlastné kľúče typu Symbol vrátane kľúčov nevymenovateľných vlastností. To, či je vlastnosť vlastná, nezávisí od toho, či je vymenovateľná.
Pri obyčajných objektoch sa názvy, ktoré sú indexmi poľa, objavia ako prvé vo vzostupnom číselnom poradí; ostatné reťazcové názvy nasledujú v poradí vytvorenia vlastností. Nejde o abecedné zoradenie. Objekty Proxy môžu zoznam a poradie upraviť pomocou pasce ownKeys, s ohľadom na obmedzenia špecifikácie. Ak je cieľový objekt rozšíriteľný, pasca môže uviesť reťazcový kľúč, ktorému nezodpovedá žiadny deskriptor vlastnej vlastnosti, alebo vynechať reťazcový kľúč konfigurovateľnej vlastnej vlastnosti cieľového objektu.
null a undefined spôsobia TypeError; ostatné primitívne hodnoty sa prevedú na objekty. Príklad ukazuje poradie indexov a zahrnutie hidden, ktorá je pri tomto použití Object.defineProperty predvolene nevymenovateľná. Vlastnosť inherited a kľúč Symbol sa vynechávajú.
Príklady
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)));Výsledok
["2","10","label","hidden"] ["2","10","label"]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.