Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes