Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — descrittori delle proprietà proprie

Per un oggetto ordinario, Object.getOwnPropertyDescriptors restituisce i descrittori di tutte le sue proprietà proprie, comprese quelle non enumerabili e quelle con chiave Symbol. Permette di esaminare gli attributi o copiare le proprietà senza trasformare gli accessor in valori.

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.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) restituisce un nuovo oggetto ordinario. Il metodo ottiene da obj l’elenco delle chiavi delle proprietà proprie e include il descrittore di ciascuna chiave elencata se obj ne segnala uno. Tiene conto delle chiavi stringa e di tipo Symbol, comprese quelle delle proprietà non enumerabili; esclude le proprietà ereditate.

Il descrittore di una proprietà dati contiene value, writable, enumerable e configurable. Un descrittore di accessor contiene get e set al posto di value e writable; una funzione mancante è rappresentata da undefined. Leggere i descrittori di un oggetto ordinario non invoca i suoi getter. Con un Proxy, tuttavia, possono essere attivate trap e possono verificarsi eccezioni. Il risultato può anche essere incompleto senza che venga sollevata alcuna eccezione: la trap ownKeys può omettere la chiave di una proprietà propria configurabile di un oggetto bersaglio estensibile, anche se il proxy continua a segnalare un descrittore di proprietà propria per quella chiave. In tal caso il metodo omette quel descrittore dal risultato.

Per un oggetto ordinario, il modello Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) crea una copia superficiale con lo stesso prototipo e gli stessi attributi delle proprietà proprie. A differenza di Object.assign, conserva gli accessor e le proprietà non enumerabili. Gli oggetti annidati restano condivisi; non è un metodo generale per clonare oggetti che dipendono da slot interni, come Map.

null e undefined causano un TypeError; gli altri valori primitivi vengono convertiti in oggetti wrapper. Il metodo fa parte di ECMAScript 2017, non delle Web APIs. Il supporto nel browser di destinazione va verificato separatamente: la disponibilità in Node 24 non lo dimostra.

Esempi

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Risultato

0
7 false
function
14 1
true

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