Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Reflect.defineProperty — définir des propriétés avec un résultat booléen

Reflect.defineProperty définit ou modifie une propriété propre d’un objet à l’aide d’un descripteur. La méthode renvoie true ou false, mais ne garantit pas une exécution sans exception.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Reflect.defineProperty(target, propertyKey, attributes)

Reflect.defineProperty(target, propertyKey, attributes) définit ou modifie une propriété propre de target. La clé est convertie en chaîne ou en symbole, et attributes est un objet descripteur. La méthode renvoie true si l’opération réussit, ou false si les règles de l’objet la refusent.

Un descripteur de données utilise value et writable ; un descripteur d’accesseur utilise get et set. Les deux peuvent contenir enumerable et configurable. Il ne faut pas mélanger les champs de données et ceux d’accesseur. Lors de la création d’une propriété sur un objet ordinaire, les indicateurs omis valent par défaut false, et une valeur de données omise vaut par défaut undefined. Sur un objet ordinaire, les champs omis restent inchangés lorsqu’on modifie une propriété existante sans en changer la nature. Une propriété configurable peut passer du statut de propriété de données à celui de propriété d’accesseur, ou inversement. Si enumerable et configurable sont omis lors de cette conversion, ils conservent leurs valeurs précédentes. Par exemple, si on convertit une propriété de données configurable en propriété d’accesseur en indiquant uniquement get, les champs value et writable disparaissent et le champ set omis prend la valeur undefined.

Le piège defineProperty d’un Proxy reçoit un objet descripteur dans lequel les champs omis restent absents. Il peut créer une propriété avec des attributs différents sur l’objet cible du Proxy, dans le respect des invariants du Proxy.

Contrairement à Object.defineProperty, qui renvoie l’objet et déclenche une TypeError lorsque la définition est refusée, cette méthode renvoie un résultat booléen. Elle n’est toutefois pas exempte d’exceptions : une cible target qui n’est pas un objet, un descripteur invalide ou une exception pendant la conversion de la clé peuvent interrompre l’appel. Le piège defineProperty d’un Proxy peut également déclencher une exception.

Pour un objet ordinaire, l’ajout d’une propriété à un objet non extensible ou une modification interdite d’une propriété non configurable renvoie false. Dans l’exemple, la deuxième définition ne peut pas modifier id, car writable et configurable valent false ; sa valeur reste 7.

Exemples

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(","));

Résultat

true
false
7
id

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources