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

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.

Fuentes