CKTIS / JavaScript
Object.getOwnPropertyDescriptor — esaminare una proprietà propria
Object.getOwnPropertyDescriptor restituisce una descrizione di una proprietà propria dell’oggetto: il suo valore o gli accessor, insieme agli indicatori dei suoi attributi. Non cerca nella catena dei prototipi e restituisce undefined se l’oggetto non possiede quella proprietà propria.
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.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) legge il descrittore di una singola proprietà propria, anche se non enumerabile. Non cerca nei prototipi. Il risultato è un nuovo oggetto descrittore oppure undefined se la proprietà non si trova direttamente in obj. Anche una proprietà esistente il cui valore è undefined ha comunque un descrittore.
Un descrittore di proprietà dati contiene value, writable, enumerable e configurable. Un descrittore di proprietà accessor contiene get e set invece di value e writable; un accessor mancante ha valore undefined. Per un oggetto ordinario, la lettura del descrittore non invoca il getter. writable determina se un’assegnazione può modificare il valore, enumerable se la proprietà viene inclusa nell’enumerazione e configurable se può essere eliminata o riconfigurata.
Modificare i campi dell’oggetto restituito non modifica la proprietà originale. Per applicare un descrittore, usa Object.defineProperty, tenendo conto delle limitazioni della proprietà esistente. Il descrittore non è una copia profonda: un oggetto memorizzato in value resta la stessa referenza.
key viene convertito in una chiave di proprietà: una stringa o un simbolo. Passare null o undefined come obj genera un TypeError; gli altri valori primitivi vengono convertiti in oggetti wrapper. Per un Proxy, l’operazione può invocare la trap getOwnPropertyDescriptor, quindi può avere effetti collaterali o generare un’eccezione.
Esempi
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Risultato
42 false true true 42 undefined
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.