CKTIS / JavaScript
Object.getOwnPropertyNames — nomi delle proprietà proprie
Object.getOwnPropertyNames(obj) restituisce un nuovo array di chiavi stringa. Per gli oggetti ordinari, comprende le chiavi di tutte le proprietà proprie con chiave stringa, incluse quelle non enumerabili. Le chiavi Symbol sono escluse e la trap ownKeys di un Proxy può influire sull’elenco.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
Object.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) è un metodo statico: chiamalo su Object, non sull’oggetto esaminato. Restituisce un nuovo array contenente solo le chiavi stringa del risultato dell’operazione interna [[OwnPropertyKeys]], senza controllare i descrittori delle proprietà. Per gli oggetti ordinari include tutte le chiavi stringa delle proprietà proprie, indipendentemente dall’attributo enumerable, ma non quelle delle proprietà ereditate. Il metodo restituisce le chiavi, non i valori delle proprietà.
Negli oggetti ordinari, Object.keys(obj) include solo le proprietà proprie enumerabili con chiavi stringa. Object.getOwnPropertySymbols(obj) restituisce le chiavi Symbol delle proprietà proprie, mentre Reflect.ownKeys(obj) restituisce sia le chiavi stringa sia le chiavi Symbol delle proprietà proprie, comprese quelle non enumerabili. «Propria» ed «enumerabile» indicano caratteristiche diverse.
Negli oggetti ordinari, i nomi che sono indici di array compaiono per primi, in ordine numerico crescente; le altre chiavi stringa seguono l’ordine di creazione delle proprietà. Non è un ordinamento alfabetico. Gli oggetti Proxy possono personalizzare l’elenco e l’ordine tramite la trap ownKeys, nel rispetto dei vincoli della specifica. Se l’oggetto bersaglio è estensibile, la trap può indicare una chiave stringa a cui non corrisponde alcun descrittore di proprietà propria, oppure omettere la chiave stringa di una proprietà propria configurabile dell’oggetto bersaglio.
null e undefined causano un TypeError; gli altri valori primitivi vengono convertiti in oggetti. L’esempio mostra l’ordinamento degli indici e l’inclusione di hidden, che con questo uso di Object.defineProperty è non enumerabile per impostazione predefinita. La proprietà inherited e la chiave Symbol vengono escluse.
Esempi
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)));Risultato
["2","10","label","hidden"] ["2","10","label"]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.