Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti