Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.defineProperty — definire proprietà con un risultato booleano

Reflect.defineProperty definisce o modifica una proprietà propria di un oggetto usando un descrittore. Restituisce true o false, ma non garantisce un’esecuzione priva di eccezioni.

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.defineProperty(target, propertyKey, attributes)

Reflect.defineProperty(target, propertyKey, attributes) definisce o modifica una proprietà propria di target. La chiave viene convertita in una stringa o in un simbolo, e attributes è un oggetto descrittore. Il metodo restituisce true se l’operazione riesce, oppure false se le regole dell’oggetto la rifiutano.

Un descrittore di dati usa value e writable; un descrittore di accessori usa get e set. Entrambi possono contenere enumerable e configurable. I campi di dati non devono essere combinati con quelli di accessori. Quando si crea una proprietà su un oggetto ordinario, gli indicatori omessi hanno valore predefinito false e un valore di dati omesso ha valore predefinito undefined. In un oggetto ordinario, quando si modifica una proprietà esistente senza cambiarne il tipo, i campi omessi restano invariati. Una proprietà configurabile può passare da proprietà di dati a proprietà con accessori o viceversa. Se durante la conversione si omettono enumerable e configurable, questi mantengono i valori precedenti. Ad esempio, se si converte una proprietà di dati configurabile in una proprietà con accessori specificando solo get, i campi value e writable vengono eliminati e il campo set omesso assume il valore undefined.

Il trap defineProperty di un Proxy riceve un oggetto descrittore in cui i campi omessi restano assenti. Può creare una proprietà con attributi diversi sull’oggetto sottostante al Proxy, nel rispetto degli invarianti del Proxy.

A differenza di Object.defineProperty, che restituisce l’oggetto e genera un TypeError se la definizione viene rifiutata, questo metodo restituisce un risultato booleano. Non è però privo di eccezioni: un target che non è un oggetto, un descrittore non valido o un’eccezione durante la conversione della chiave possono interrompere la chiamata. Anche il trap defineProperty di un Proxy può generare un’eccezione.

Per un oggetto ordinario, aggiungere una proprietà a un oggetto non estensibile o apportare una modifica vietata a una proprietà non configurabile restituisce false. Nell’esempio, la seconda definizione non può modificare id perché writable e configurable sono false; il valore resta 7.

Esempi

const item = {};

console.log(Reflect.defineProperty(item, "id", {
  value: 7,
  enumerable: true,
  writable: false,
  configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));

Risultato

true
false
7
id

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