CKTIS / JavaScript
PropertyDescriptor.value — valore di una proprietà di dati
Il campo `value` contiene il valore memorizzato in una proprietà di dati. Ometterlo nel descrittore in ingresso non equivale a indicare `value: undefined`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
Object.defineProperty(target, key, { value: newValue })
const descriptor = Object.getOwnPropertyDescriptor(target, key);
if (descriptor !== undefined && Object.hasOwn(descriptor, "value")) {
const storedValue = descriptor.value;
}PropertyDescriptor.value indica il campo value dell’oggetto che descrive una proprietà di dati, non una proprietà di un costruttore globale. Corrisponde al campo [[Value]] della specifica e può contenere qualsiasi valore JavaScript, inclusi un oggetto, una funzione o undefined. writable stabilisce se un’assegnazione può sostituire il valore; non congela un oggetto memorizzato.
Su un oggetto ordinario, Object.defineProperty() usa undefined come valore predefinito quando crea una proprietà di dati senza il campo value. Se si modifica una proprietà di dati esistente senza cambiarne il tipo, omettere value mantiene il valore precedente, mentre value: undefined ne richiede la sostituzione. Se la proprietà di dati esistente non è configurabile né scrivibile, fornire un valore diverso secondo SameValue (il confronto usato da Object.is) genera un TypeError.
Un descrittore di accesso usa get e set al posto di value e writable. Nel descrittore in ingresso non si possono combinare campi dei due gruppi: anche { value: undefined, get: undefined } genera un TypeError. Contano anche i campi ereditati dal descrittore in ingresso.
Object.getOwnPropertyDescriptor() restituisce undefined se non esiste una proprietà propria con quella chiave. Se restituisce un descrittore, Object.hasOwn(descriptor, "value") distingue una proprietà di dati che contiene undefined da una proprietà di accesso. Il descrittore non è una vista aggiornata in tempo reale: modificare descriptor.value non sostituisce il valore sull’oggetto di destinazione. Se il valore memorizzato è un oggetto, il descrittore fa riferimento allo stesso oggetto, non a una copia.
Esempi
{
const target = { score: 7, get label() { return "ready"; } };
const before = Object.getOwnPropertyDescriptor(target, "score");
Object.defineProperty(target, "score", { enumerable: false });
console.log(String(target.score));
Object.defineProperty(target, "score", { value: undefined });
const data = Object.getOwnPropertyDescriptor(target, "score");
const accessor = Object.getOwnPropertyDescriptor(target, "label");
console.log(`${Object.hasOwn(data, "value")}: ${data.value}`);
console.log(`${Object.hasOwn(accessor, "value")}: ${target.label}`);
console.log(String(before.value));
}Risultato
7 true: undefined false: ready 7
Omettere `value` conserva `7`; specificare `value: undefined` sostituisce il valore. Il descrittore di `label` non ha un campo proprio `value`, anche se leggere `target.label` richiama il getter e restituisce `ready`. Il descrittore `before`, ottenuto prima, contiene ancora `7`.
Lezioni correlate
- JavaScript · Lezione 45 · Avanzato · Versione: 4