CKTIS / JavaScript
Reflect.preventExtensions — impedir la extensión de un objeto
Reflect.preventExtensions(target) impide que se añadan nuevas propiedades propias a un objeto y devuelve un valor booleano. No congela las propiedades existentes y aún puede lanzar excepciones.
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
Reflect.preventExtensions(target)Reflect.preventExtensions(target) invoca la operación interna [[PreventExtensions]] del objeto. Devuelve true si la operación tiene éxito o false si se rechaza. El argumento debe ser un objeto; un valor primitivo, incluido null, provoca un TypeError. Las excepciones de la operación interna se propagan: que el resultado sea booleano no significa que no puedan producirse excepciones.
En un objeto ordinario, el éxito impide permanentemente añadir nuevas propiedades propias, incluidas las que tienen claves de tipo Symbol. Una llamada posterior devuelve true. Tampoco se puede cambiar el prototipo por otro. Las propiedades existentes aún se pueden modificar o eliminar si sus descriptores lo permiten; los objetos anidados no se modifican.
Esto no equivale a Object.seal ni a Object.freeze: el método no cambia los atributos configurable ni writable. Object.preventExtensions devuelve su argumento si tiene éxito y lanza un TypeError cuando la operación devuelve false; devuelve los valores primitivos sin modificarlos. En cambio, Reflect.preventExtensions expone el resultado booleano y rechaza los valores primitivos.
Un Proxy puede interceptar la operación mediante su trampa preventExtensions. La trampa puede rechazarla devolviendo false, pero indicar que ha tenido éxito mientras el objeto de destino siga siendo extensible provoca un TypeError. En el ejemplo, Reflect.set muestra un intento fallido de añadir una propiedad sin depender del modo estricto.
Ejemplos
const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));Resultado
true false false 2 true 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.