Ver los atributos
const libro = { titulo: "Rayuela" };
console.log(Object.getOwnPropertyDescriptor(libro, "titulo"));
console.log(Object.getOwnPropertyDescriptor([1, 2], "length"));
console.log(Object.getOwnPropertyDescriptor(Array.prototype, "map").enumerable);
Una propiedad de datos tiene cuatro atributos:
| Atributo | Si es false… |
|---|---|
value |
(el valor) |
writable |
No se puede cambiar el valor |
enumerable |
No aparece en Object.keys, for...in, el spread ni JSON.stringify |
configurable |
No se puede borrar ni cambiar sus atributos |
Por eso map no aparece al recorrer un array: en el prototipo, los métodos no son enumerables. Y el length de un array se puede cambiar, pero no borrar.
Definir con atributos
Object.defineProperty crea o modifica una propiedad con los atributos que elijas. Lo que no indiques queda en false:
const pedido = { id: 7 };
Object.defineProperty(pedido, "creado", {
value: "2026-11-21",
enumerable: true, // visible, pero…
writable: false, // …de solo lectura
});
pedido.creado = "otra fecha"; // se ignora (TypeError en modo estricto)
console.log(pedido.creado);
console.log(Object.keys(pedido));
Object.defineProperties(obj, { a: {…}, b: {…} }) define varias de una vez, y Object.getOwnPropertyDescriptors(obj) las lee todas.
Propiedades de acceso
En lugar de value y writable, una propiedad puede tener get y set: son los getters y setters que viste en las clases.
const temperatura = { celsius: 20 };
Object.defineProperty(temperatura, "fahrenheit", {
get() { return this.celsius * 9 / 5 + 32; },
set(f) { this.celsius = (f - 32) * 5 / 9; },
enumerable: true,
});
console.log(temperatura.fahrenheit);
temperatura.fahrenheit = 212;
console.log(temperatura.celsius);
Copias que conservan los atributos
El spread y Object.assign copian solo valores: un getter se ejecuta y se copia su resultado, y los atributos se pierden. Para una copia fiel:
const original = {};
Object.defineProperty(original, "fija", { value: 1, enumerable: true });
const conSpread = { ...original };
const fiel = Object.defineProperties({}, Object.getOwnPropertyDescriptors(original));
console.log(Object.getOwnPropertyDescriptor(conSpread, "fija").writable); // true: se perdió
console.log(Object.getOwnPropertyDescriptor(fiel, "fija").writable); // false
Resumen
- Cada propiedad tiene atributos:
value,writable,enumerableyconfigurable(ogetyset). Object.getOwnPropertyDescriptorlos lee;Object.definePropertylos define.- Con
defineProperty, lo que no indicas queda enfalse. enumerable: falseoculta la propiedad al recorrer y al convertir a JSON.- Spread y
assigncopian valores, no atributos;getOwnPropertyDescriptors+definePropertiescopian todo.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Lo que hay detrás de cada propiedad
Resuelto
Elige una respuesta en cada pregunta.
¿Qué tres atributos tiene una propiedad de datos, además de su valor?
Con
Object.defineProperty(obj, "x", { value: 1 }), ¿cómo quedan los atributos que no indicaste?¿Qué significa
enumerable: false?¿Qué hace
Object.freezeen términos de descriptores?
Ordena la salida: Una propiedad discreta
Resuelto
Una propiedad definida con defineProperty y otra con un literal. Ordena lo que aparecería en la consola.
1const o = {};2Object.defineProperty(o, "id", { value: 7 });3o.id = 99;4 5console.log(o.id);6console.log(Object.keys(o).length, JSON.stringify(o));7const d = Object.getOwnPropertyDescriptor(o, "id");8console.log(d.writable, d.enumerable, d.configurable);9console.log(Object.getOwnPropertyDescriptor({ x: 1 }, "x").writable);Consola, de arriba abajo
- false false false
- 7
- true
- 0 {}
defineProperty deja en false todo lo que no indicaste: la asignación se ignora (fuera del modo estricto) y la propiedad no aparece al recorrer ni al convertir a JSON. Una propiedad creada con un literal, en cambio, tiene todo en true.
Detective: Redefinir lo que no se puede
Resuelto
La actualización de la versión falla. El error salta en una línea, pero la causa está en otra. Encuéntrala.
Consola
config.js:5
Object.defineProperty(config, "version", { value: "2.0" });
^
TypeError: Cannot redefine property: versionPaso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Una propiedad oculta
Resuelto
Escribe agregarOculta(obj, clave, valor): una propiedad que se lee y se cambia, pero no aparece al recorrer.
$ node programa.js
Lo que debe cumplir
- Imprime
abc123y{"nombre":"Ana"}(pendiente) - La propiedad se puede cambiar (pendiente)
- Usa
Object.definePropertyconenumerable: false(pendiente)
Una solución
1function agregarOculta(obj, clave, valor) {2 Object.defineProperty(obj, clave, {3 value: valor,4 writable: true,5 configurable: true,6 enumerable: false,7 });8}9 10const usuario = { nombre: "Ana" };11agregarOculta(usuario, "token", "abc123");12 13console.log(usuario.token);14console.log(JSON.stringify(usuario));Útil para datos internos que no deberían viajar al guardar o enviar el objeto. Ojo: "oculta" no es "privada". Cualquiera puede leerla si conoce su nombre, o verla con Object.getOwnPropertyNames. Para privacidad de verdad están los campos # de las clases.