CKTIS / JavaScript
Reflect — opérations explicites sur les objets
Reflect fournit des méthodes statiques pour lire, écrire et examiner des objets. Le résultat booléen d’une écriture permet de vérifier si l’opération a réussi, mais ne signifie pas que la méthode ne peut jamais lever d’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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect est un objet intégré d’ECMAScript, et non une fonction ou un constructeur : Reflect() et new Reflect() lèvent une TypeError. Ses méthodes exposent des opérations correspondant aux mécanismes internes des objets.
Reflect.get lit une propriété, tandis que Reflect.set tente de l’écrire et renvoie un booléen, et non la valeur affectée. Dans les deux méthodes, le paramètre facultatif receiver vaut par défaut target et détermine la valeur de this lors de l’appel des accesseurs. Reflect.ownKeys renvoie toutes les clés propres de type chaîne et symbole, y compris celles qui ne sont pas énumérables ; les clés héritées sont exclues.
Reflect.defineProperty renvoie false lorsqu’un objet refuse un descripteur valide, tandis que Object.defineProperty lève une exception dans ce cas. Un résultat booléen ne garantit pas l’absence d’exceptions : des arguments invalides et le code des accesseurs ou des pièges Proxy peuvent en provoquer. Les opérations sur les propriétés exigent un objet comme target.
Dans l’exemple, la propriété n’est ni énumérable ni modifiable. Reflect.set renvoie false même en mode strict, la valeur reste 10 et Reflect.ownKeys trouve toujours la clé.
Exemples
"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
value: 10,
writable: false,
enumerable: false,
configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));Résultat
10 false score 10
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.