CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — esaminare una proprietà propria
Reflect.getOwnPropertyDescriptor(target, key) restituisce il descrittore di una proprietà propria oppure undefined. Permette di esaminare valore, accessor e attributi di una proprietà senza percorrere 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
Reflect.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) descrive solo una proprietà propria di target, anche se non è enumerabile. Restituisce un nuovo oggetto descrittore oppure undefined se la proprietà non è propria. Non cerca le proprietà ereditate nella catena dei prototipi; una proprietà propria il cui valore è undefined ha comunque un descrittore.
Un descrittore di dati contiene value, writable, enumerable e configurable. Un descrittore di accesso contiene get e set al posto di value e writable; i loro valori sono funzioni oppure undefined. Esaminare il descrittore di un oggetto ordinario non invoca il suo getter. Modificare il descrittore restituito non ridefinisce di per sé la proprietà; per farlo, si può usare Object.defineProperty.
target deve essere un oggetto; qualsiasi valore primitivo, inclusi null e undefined, causa un TypeError. Questo comportamento differisce da Object.getOwnPropertyDescriptor, che incapsula i valori primitivi diversi da null e undefined. L’operazione ToPropertyKey converte key in una chiave di proprietà. Se key è un oggetto, l’operazione lo converte prima in un valore primitivo, per esempio chiamando il suo metodo Symbol.toPrimitive. Se il valore primitivo è un simbolo, viene mantenuto come chiave; altrimenti viene convertito in una stringa.
Non presumere che l’operazione sia sempre priva di effetti collaterali: la conversione di key può eseguire codice dell’utente e un Proxy può attivare la trappola getOwnPropertyDescriptor. Le eccezioni risultanti vengono propagate al chiamante. L’esempio mostra che una proprietà ereditata viene ignorata e che modificare descriptor.value non cambia item.score.
Esempi
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Risultato
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42Il 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.