CKTIS / JavaScript
Object.getOwnPropertyNames — názvy vlastních vlastností
Object.getOwnPropertyNames(obj) vrací nové pole řetězcových klíčů. U běžných objektů zahrnuje řetězcové klíče všech vlastních vlastností, včetně těch, které se nezahrnují do výčtu. Klíče typu Symbol se vynechávají a u objektu Proxy může seznam ovlivnit past ownKeys.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) je statická metoda: volejte ji na Object, nikoli na zkoumaném objektu. Vrací nové pole obsahující pouze řetězcové klíče z výsledku interní operace [[OwnPropertyKeys]], aniž by kontrolovala deskriptory vlastností. U běžných objektů zahrnuje všechny vlastní řetězcové klíče bez ohledu na atribut enumerable, nikoli však klíče zděděných vlastností. Metoda vrací klíče, nikoli hodnoty vlastností.
U běžných objektů zahrnuje Object.keys(obj) pouze vlastní vlastnosti s řetězcovými klíči, které mají atribut enumerable nastavený na true. Object.getOwnPropertySymbols(obj) vrací vlastní klíče typu Symbol, zatímco Reflect.ownKeys(obj) vrací vlastní řetězcové klíče i vlastní klíče typu Symbol, včetně klíčů vlastností s atributem enumerable nastaveným na false. To, zda je vlastnost vlastní, je nezávislé na tom, zda se zahrnuje do výčtu.
U běžných objektů se názvy, které jsou indexy pole, objevují jako první ve vzestupném číselném pořadí; ostatní řetězcové názvy následují v pořadí vytvoření vlastností. Nejde o abecední řazení. Objekty Proxy mohou seznam a pořadí upravit pomocí pasti ownKeys, s ohledem na omezení specifikace. Je-li cílový objekt rozšiřitelný, může past uvést řetězcový klíč, jemuž neodpovídá žádný deskriptor vlastní vlastnosti, nebo vynechat řetězcový klíč konfigurovatelné vlastní vlastnosti cílového objektu.
null a undefined způsobí TypeError; ostatní primitivní hodnoty se převedou na objekty. Příklad ukazuje pořadí indexů i to, že výsledek zahrnuje hidden, přestože při tomto použití Object.defineProperty má tato vlastnost ve výchozím nastavení atribut enumerable nastavený na false. Vlastnost inherited a klíč Symbol jsou vynechány.
Pří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ýsledek
["2","10","label","hidden"] ["2","10","label"]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.