Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.defineProperties: più descrittori insieme

Object.defineProperties definisce più proprietà con descrittori completi dopo aver raccolto e convalidato l’intera mappa.

Versione: ECMAScript 5 onward; example target: Node.js 24.22.2

Sintassi

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) richiede che obj sia un oggetto e non esegue il boxing delle primitive. properties passa per ToObject, quindi null e undefined generano TypeError. Il metodo fotografa le chiavi proprie stringa e simbolo della mappa e include solo quelle il cui descrittore proprio corrente è enumerabile.

Prima legge ogni valore selezionato e lo converte con ToPropertyDescriptor; soltanto dopo aver raccolto con successo tutti i descrittori inizia a definire proprietà sul target. Un descrittore invalido o un getter che genera eccezione in questa fase lascia dunque invariato il target. La definizione è però sequenziale, non transazionale: se una definizione successiva fallisce, le precedenti possono restare.

Il metodo restituisce lo stesso obj ed esiste da ECMAScript 5. Quando si crea una nuova proprietà, writable, enumerable e configurable omessi diventano false, mentre value, get e set omessi diventano undefined; aggiornando una proprietà esistente, i campi omessi restano invariati. value/writable non possono essere uniti a get/set, e un accessore deve essere invocabile o undefined. Getter e trap Proxy sulla mappa o sul target possono eseguire codice e generare eccezioni.

Esempi

const token = Symbol("token");
const target = {};
Object.defineProperties(target, {
  visible: { value: 3, enumerable: true },
  doubled: { get() { return this.visible * 2; }, enumerable: true },
  [token]: { value: "ok" }
});
console.log(Object.keys(target).join(","), target.doubled, target[token]);
console.log(Object.getOwnPropertyDescriptor(target, "visible").writable);
const untouched = {};
try {
  Object.defineProperties(untouched, {
    first: { value: 1 },
    bad: { get: 1 }
  });
} catch (error) { console.log(error.name, Object.hasOwn(untouched, "first")); }
const partial = {};
Object.defineProperty(partial, "locked", { value: 1 });
try {
  Object.defineProperties(partial, {
    added: { value: 2 },
    locked: { value: 3 }
  });
} catch (error) { console.log(error.name, partial.added, partial.locked); }

Risultato

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

L’esempio mostra simboli, default restrittivi, convalida preliminare e modifica parziale durante la definizione.

Fonti