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

CKTIS / JavaScript

Reflect.set — atribuição de propriedade com resultado booleano

Reflect.set executa uma operação de atribuição de propriedade e devolve um valor booleano que indica se foi bem-sucedida. O receiver opcional permite distinguir o objeto onde começa a procura da propriedade daquele que recebe a escrita.

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.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) invoca a operação interna [[Set]] do objeto target. O argumento key é convertido numa chave de propriedade: uma cadeia de caracteres ou um símbolo. Se receiver for omitido, o valor predefinido é target.

O resultado é true ou false, não o valor atribuído. Em objetos comuns, false pode indicar, por exemplo, uma tentativa de alterar uma propriedade com writable: false, de usar um acessor sem setter ou de adicionar uma propriedade a um recetor não extensível. Por si só, um resultado false não provoca uma exceção, mesmo em modo estrito, ao contrário de uma atribuição rejeitada target[key] = value nesse modo.

A procura do descritor começa em target e pode percorrer os seus protótipos. Para uma propriedade de dados gravável, a escrita geralmente cria ou atualiza uma propriedade própria de receiver, sujeita às respetivas restrições. Quando se chama um setter, receiver é passado como argumento this. Se o setter for uma função JavaScript comum em modo não estrito, o seu this assume o valor global de this em vez de null ou undefined, e os restantes valores primitivos são convertidos em objetos invólucro. O valor devolvido pelo setter é ignorado. Assim, true não garante que uma leitura posterior devolva value.

O método não é um mecanismo de captura de erros: um target que não seja um objeto provoca um TypeError, e as exceções da conversão da chave, de um setter ou de uma armadilha de Proxy são propagadas. Ao definir diretamente uma propriedade própria, não se percorre a cadeia de protótipos nem se invocam setters herdados, mas continuam a aplicar-se as restrições do descritor de uma propriedade própria já existente. Por exemplo, não se pode alterar o valor de uma propriedade de dados própria que não seja configurável nem gravável.

Exemplos

"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);

Object.defineProperty(target, "fixed", {
  value: 10,
  writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);

Resultado

true
1 7
false
10

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