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

CKTIS / JavaScript

Object.seal — sellar un objeto

Object.seal impide añadir y eliminar propiedades propias de un objeto, pero no lo hace inmutable. En un objeto ordinario, las propiedades de datos existentes que admiten escritura aún pueden recibir nuevos valores, y los objetos anidados no se sellan automáticamente.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Object.seal(obj)

Object.seal(obj) modifica el objeto proporcionado y devuelve ese mismo objeto, sin crear una copia. Impide que se amplíe y establece configurable: false en todas sus propiedades propias, incluidas las no enumerables y las que tienen claves Symbol. Después no se pueden añadir ni eliminar propiedades propias, cambiar su enumerabilidad ni convertir propiedades de datos en accesores o viceversa.

Sellar no significa hacer inmutable. En un objeto ordinario, las propiedades de datos existentes con writable: true aún pueden recibir valores nuevos y se puede cambiar writable de true a false, pero no al contrario. En un objeto de espacio de nombres de módulo sellado, los descriptores de las propiedades correspondientes a las exportaciones indican writable: true, pero el objeto rechaza tanto las asignaciones a esas propiedades como los intentos de cambiar su atributo writable a false. Los setters existentes pueden seguir funcionando. La operación es superficial: los objetos anidados no se sellan automáticamente.

Object.preventExtensions impide añadir propiedades propias, pero por sí solo no hace que las propiedades existentes dejen de ser configurables. En un objeto ordinario, Object.freeze también establece writable: false en las propiedades de datos propias; igualmente, actúa de forma superficial. Comprueba el sellado con Object.isSealed.

En modo estricto, una asignación no permitida de una propiedad nueva o la eliminación de una propiedad existente mediante delete provoca un TypeError; fuera del modo estricto, estas operaciones suelen fallar sin lanzar una excepción. Object.seal puede lanzar una excepción si el sellado falla, por ejemplo, con algunos objetos Proxy. En ECMAScript moderno, un argumento que no sea un objeto se devuelve sin cambios.

Ejemplos

"use strict";

const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;

console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);

try {
  settings.extra = 1;
} catch (error) {
  console.log(error instanceof TypeError);
}

console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));

Resultado

true
true
3 true
true
false
false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes