CKTIS / JavaScript
Reflect.defineProperty — definir propriedades com um resultado booleano
Reflect.defineProperty define ou altera uma propriedade própria de um objeto através de um descritor. Devolve true ou false, mas não garante uma execução sem exceções.
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.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) define ou altera uma propriedade própria de target. A chave é convertida numa cadeia ou num símbolo, e attributes é um objeto descritor. O método devolve true se a operação for bem-sucedida, ou false se as regras do objeto a rejeitarem.
Um descritor de dados utiliza value e writable; um descritor de acessor utiliza get e set. Ambos podem conter enumerable e configurable. Os campos de dados não devem ser combinados com os campos de acessor. Ao criar uma propriedade num objeto comum, os indicadores omitidos têm o valor predefinido false, e um valor de dados omitido tem o valor predefinido undefined. Num objeto comum, os campos omitidos mantêm-se inalterados quando se modifica uma propriedade existente sem mudar o seu tipo. Uma propriedade configurável pode passar de propriedade de dados a propriedade de acessor ou vice-versa. Se enumerable e configurable forem omitidos durante a conversão, conservam os valores anteriores. Por exemplo, ao converter uma propriedade de dados configurável numa propriedade de acessor indicando apenas get, os campos value e writable são descartados e o campo set omitido fica com o valor undefined.
A armadilha defineProperty de um Proxy recebe um objeto descritor que continua a não incluir os campos omitidos. Pode criar uma propriedade com atributos diferentes no objeto-alvo do Proxy, desde que respeite os invariantes do Proxy.
Ao contrário de Object.defineProperty, que devolve o objeto e lança um TypeError quando a definição é rejeitada, este método devolve um resultado booleano. No entanto, não está isento de exceções: um target que não seja um objeto, um descritor inválido ou uma exceção durante a conversão da chave podem interromper a chamada. A armadilha defineProperty de um Proxy também pode lançar uma exceção.
Num objeto comum, adicionar uma propriedade a um objeto não extensível ou fazer uma alteração não permitida a uma propriedade não configurável devolve false. No exemplo, a segunda definição não pode alterar id, porque writable e configurable são false; o valor permanece 7.
Exemplos
const item = {};
console.log(Reflect.defineProperty(item, "id", {
value: 7,
enumerable: true,
writable: false,
configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));Resultado
true false 7 id
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.