Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti