CKTIS / JavaScript
Object.getOwnPropertySymbols — chiavi Symbol proprie
Object.getOwnPropertySymbols(obj) restituisce un array di chiavi di tipo Symbol. Negli oggetti ordinari sono le chiavi delle proprietà proprie, comprese quelle non enumerabili. Il metodo esclude le chiavi stringa e non percorre la catena dei prototipi.
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.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) è un metodo statico di Object che crea un nuovo array contenente solo le chiavi di tipo Symbol dell’elenco restituito dall’operazione interna [[OwnPropertyKeys]] dell’oggetto. Restituisce chiavi, non valori o descrizioni dei simboli. Per leggere il valore di una proprietà, usa obj[key].
Il metodo esclude le chiavi stringa e non percorre la catena dei prototipi. Non controlla i descrittori delle proprietà: un Proxy con un oggetto di destinazione estensibile può segnalare un simbolo tramite la trap ownKeys, anche se il proxy non ha un descrittore di proprietà propria per quel simbolo.
Negli oggetti ordinari, il risultato include le chiavi delle proprietà proprie enumerabili e non enumerabili e i simboli compaiono nell’ordine di creazione di tali proprietà. Object.keys(obj) restituisce solo le chiavi stringa delle proprietà proprie enumerabili, Object.getOwnPropertyNames(obj) restituisce tutte le chiavi stringa proprie e Reflect.ownKeys(obj) restituisce entrambi i tipi di chiavi proprie.
L’argomento viene convertito in un oggetto; null e undefined causano un TypeError. I simboli non garantiscono la privacy: questo metodo può individuare queste chiavi anche quando enumerable: false.
Nell’esempio, il risultato contiene visible e hidden, ma né inherited né name. I confronti verificano l’identità dei simboli e l’ultima riga legge i valori delle proprietà corrispondenti.
Esempi
const inherited = Symbol('inherited');
const visible = Symbol('visible');
const hidden = Symbol('hidden');
const obj = Object.create({ [inherited]: 10 });
obj.name = 'demo';
obj[visible] = 20;
Object.defineProperty(obj, hidden, {
value: 30,
enumerable: false
});
const keys = Object.getOwnPropertySymbols(obj);
console.log(keys.length);
console.log(keys[0] === visible, keys[1] === hidden);
console.log(keys.includes(inherited));
console.log(keys.map(key => obj[key]).join(','));Risultato
2 true true false 20,30
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.