CKTIS / JavaScript
Object.preventExtensions — impedir nuevas propiedades
Object.preventExtensions(obj) impide de forma irreversible añadir propiedades propias a un objeto y devuelve ese mismo objeto. No congela los valores existentes ni los objetos anidados.
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.preventExtensions(obj)Object.preventExtensions(obj) hace que un objeto no sea extensible: no se pueden añadir propiedades propias nuevas, incluidas las que tienen claves symbol. El método modifica el objeto proporcionado y devuelve la misma referencia, no una copia. Usa Object.isExtensible(obj) para comprobar su estado. La operación no se puede revertir.
En un objeto ordinario, las propiedades existentes conservan sus descriptores: aún se pueden asignar valores a las propiedades escribibles y eliminar las configurables. Una propiedad eliminada no se puede volver a añadir. Tampoco se puede cambiar el prototipo por otro; sigue estando permitido especificar el prototipo que ya tiene.
Un array tipado de longitud fija respaldado por un ArrayBuffer no redimensionable puede hacerse no extensible, pero no se pueden eliminar sus elementos indexados existentes, aunque sus descriptores indiquen configurable: true.
Una asignación que crearía una nueva propiedad propia lanza TypeError en modo estricto y normalmente se ignora fuera de ese modo. Object.defineProperty lanza TypeError cuando se intenta añadir una propiedad, independientemente del modo. El propio método también lanza TypeError si la operación interna se niega a impedir la extensión, por ejemplo, debido a una trampa de Proxy que devuelve false. En ECMAScript actual, los argumentos primitivos, incluidos null y undefined, se devuelven sin cambios.
Object.seal ofrece una protección mayor: establece configurable en false para todas las propiedades propias, lo que impide eliminarlas. En un objeto ordinario sellado, el atributo writable de una propiedad de datos escribible aún se puede cambiar de true a false. Un objeto sellado de espacio de nombres de módulo indica writable: true en los descriptores de las propiedades que corresponden a los enlaces exportados, pero rechaza cambiar ese atributo a false. En un objeto ordinario, Object.freeze establece además writable en false para todas las propiedades de datos propias. En un objeto de espacio de nombres de módulo, Object.freeze lanza TypeError cuando intenta establecer writable en false para una propiedad que corresponde a un enlace exportado. Si ese enlace aún no se ha inicializado, la consulta del descriptor de la propiedad puede lanzar ReferenceError antes de ese intento. Ninguna de estas operaciones afecta recursivamente a los objetos anidados. Esta es una API del lenguaje ECMAScript, no una API web del navegador; el estándar por sí solo no acredita su compatibilidad con un navegador concreto.
Ejemplos
"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
item.extra = 3;
} catch (error) {
console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));Resultado
true false 2 true TypeError 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.