CKTIS / JavaScript
Object.defineProperty: descrittore preciso di una proprietà
Object.defineProperty definisce o modifica una proprietà propria tramite un descrittore esplicito di dati o accessor.
Versione: ECMAScript 5 onward; example target: Node.js 24.22.2
Sintassi
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) richiede un vero oggetto come obj e non esegue il boxing delle primitive. key passa per ToPropertyKey, quindi diventa una stringa o un simbolo. descriptor viene letto da ToPropertyDescriptor e il metodo restituisce lo stesso oggetto target.
Un descrittore dati usa value e writable, mentre un descrittore accessor usa get e set; mescolare campi dei due tipi genera TypeError. Quando si crea una nuova proprietà, writable, enumerable e configurable mancanti diventano false, mentre value, get e set mancanti significano undefined; aggiornando una proprietà esistente, i campi omessi lasciano invariati gli attributi correnti. Getter e setter devono essere invocabili o undefined.
Il metodo esiste da ECMAScript 5. DefinePropertyOrThrow genera TypeError quando aggiunge una nuova proprietà a un oggetto non estensibile, quando la modifica viola le regole di una proprietà non configurabile o quando un Proxy infrange gli invarianti. Una ridefinizione compatibile di una proprietà esistente può riuscire anche su un oggetto non estensibile. Diversamente dall’assegnazione controlla gli attributi senza invocare un setter ereditato, ma leggere il descrittore e le trap Proxy può eseguire codice e generare eccezioni.
Esempi
const account = {};
const same = Object.defineProperty(account, "balance", {
value: 10, writable: false, enumerable: true, configurable: false
});
let reads = 0;
Object.defineProperty(account, "label", {
get() { return `#${++reads}`; }, configurable: true
});
console.log(same === account, Object.keys(account).join(","));
console.log(account.balance, account.label, account.label);
const balance = Object.getOwnPropertyDescriptor(account, "balance");
const label = Object.getOwnPropertyDescriptor(account, "label");
console.log(balance.writable, balance.configurable, label.set);
try { Object.defineProperty(account, "balance", { value: 11 }); }
catch (error) { console.log(error.name, account.balance); }
try { Object.defineProperty({}, "x", { value: 1, get() {} }); }
catch (error) { console.log(error.name); }Risultato
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
L’esempio definisce una proprietà dati e un getter, ispeziona gli attributi e prova due TypeError.