CKTIS / JavaScript
Reflect.isExtensible — verificar a extensibilidade de um objeto
Reflect.isExtensible(target) verifica se um objeto é extensível. Num objeto comum, a extensibilidade significa que lhe podem ser adicionadas novas propriedades próprias. O método devolve um booleano e lança um TypeError para valores primitivos.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Reflect.isExtensible(target)Reflect.isExtensible(target) devolve true quando um objeto é extensível e false quando não é. Num objeto comum, extensibilidade significa que lhe podem ser adicionadas novas propriedades próprias. O método consulta este estado, mas não o altera por si só.
Object.preventExtensions(target) impede a adição de novas propriedades próprias. Object.seal(target) e Object.freeze(target) também tornam os objetos não extensíveis, mas impõem restrições adicionais. Por isso, false não significa que o objeto esteja congelado: as propriedades existentes que permitem escrita ainda podem ser alteradas, e as propriedades configuráveis ainda podem ser eliminadas. Não é possível tornar novamente extensível um objeto comum.
O argumento tem de ser um objeto; os arrays e as funções também são objetos. Os valores primitivos, incluindo null e undefined, causam um TypeError. Esta é uma diferença importante em relação a Object.isExtensible(target), que devolve false para valores primitivos em vez de lançar uma exceção.
O método invoca a operação interna [[IsExtensible]]. Para um Proxy, pode invocar a trap isExtensible, por isso não parta do princípio de que a operação não tem efeitos secundários. Após a conversão para booleano, o resultado da trap tem de corresponder à extensibilidade real do objeto de destino; caso contrário, ocorre um TypeError. Um proxy revogado também causa um TypeError.
Exemplos
const item = { count: 1 };
console.log(Reflect.isExtensible(item));
Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
try {
Reflect.isExtensible(42);
} catch (error) {
console.log(error.name);
}Resultado
true false false 2 TypeError
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.