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.