Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Object.defineProperties: varios descriptores a la vez

Object.defineProperties define varias propiedades con descriptores completos después de reunir y validar todo el mapa.

Versión: ECMAScript 5 onward; example target: Node.js 24.22.2

Sintaxis

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) exige que obj sea un objeto y no envuelve primitivas. properties pasa por ToObject, por lo que null y undefined lanzan TypeError. El método toma una instantánea de las claves propias de texto y símbolo del mapa y solo incluye aquellas cuyo descriptor propio actual es enumerable.

Primero obtiene cada valor seleccionado y lo convierte con ToPropertyDescriptor; solo tras reunir correctamente todos los descriptores empieza a definir propiedades en el destino. Un descriptor inválido o un getter que lance en esta fase deja el destino intacto. La fase de definición sí es secuencial, no transaccional: si una definición posterior es incompatible, las anteriores pueden quedar aplicadas.

Devuelve el mismo obj y existe desde ECMAScript 5. Al crear una propiedad nueva, los campos omitidos writable, enumerable y configurable pasan a false, mientras value, get y set omitidos pasan a undefined; al actualizar una propiedad existente, los campos omitidos quedan sin cambios. No se pueden mezclar value/writable con get/set, y un accesor debe ser invocable o undefined. Getters y trampas Proxy del mapa o destino pueden ejecutar código y lanzar excepciones.

Ejemplos

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); }

Resultado

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

El ejemplo muestra símbolos, valores restrictivos, validación previa y una modificación parcial al definir.

Fuentes