CKTIS / JavaScript
PropertyDescriptor.value — valor de una propiedad de datos
El campo `value` contiene el valor almacenado en una propiedad de datos. Omitirlo en el descriptor de entrada no equivale a escribir `value: undefined`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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 designa el campo value del objeto que describe una propiedad de datos, no una propiedad de un constructor global. Corresponde al campo [[Value]] de la especificación y admite cualquier valor de JavaScript, incluidos objetos, funciones y undefined. writable determina si una asignación puede reemplazar el valor; no congela el objeto almacenado.
En un objeto ordinario, Object.defineProperty() usa undefined como valor predeterminado al crear una propiedad de datos sin el campo value. Al modificar una propiedad de datos existente sin cambiar su tipo, omitir value conserva el valor anterior, mientras que value: undefined solicita reemplazarlo. Si la propiedad de datos existente no es configurable ni escribible, proporcionar un valor distinto según SameValue (la comparación que usa Object.is) lanza un TypeError.
Un descriptor de acceso usa get y set en lugar de value y writable. El descriptor de entrada no puede mezclar campos de ambos grupos: incluso { value: undefined, get: undefined } lanza un TypeError. También cuentan los campos que hereda el descriptor de entrada.
Object.getOwnPropertyDescriptor() devuelve undefined si no hay una propiedad propia con esa clave. Si devuelve un descriptor, Object.hasOwn(descriptor, "value") distingue una propiedad de datos que contiene undefined de una propiedad de acceso. El descriptor no es una vista en vivo: cambiar descriptor.value no reemplaza el valor en el objeto de destino. Si el valor almacenado es un objeto, el descriptor hace referencia a ese mismo objeto, no a una copia.
Ejemplos
{
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));
}Resultado
7 true: undefined false: ready 7
Omitir `value` conserva `7`; indicar `value: undefined` reemplaza el valor. El descriptor de `label` no tiene un campo propio `value`, aunque al leer `target.label` se llama al getter y se obtiene `ready`. El descriptor `before`, obtenido antes, aún contiene `7`.
Lecciones relacionadas
- JavaScript · Lección 45 · Avanzado · Versión: 4