Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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
42

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.

Fonti