CKTIS / JavaScript
Reflect.get — lire une propriété avec un récepteur facultatif
`Reflect.get` lit une propriété d’un objet, y compris une propriété héritée. Lors d’une recherche ordinaire, le récepteur est transmis au getter comme argument `this`, sans changer le point de départ de la recherche.
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, propertyKey[, receiver])Reflect.get(target, propertyKey[, receiver]) effectue l’opération interne [[Get]]. Pour un objet ordinaire, la recherche porte d’abord sur target, puis remonte sa chaîne de prototypes. Une propriété absente produit undefined ; un accesseur sans getter produit également undefined.
Si receiver est omis, il prend par défaut la valeur de target. Lors d’une recherche ordinaire de propriété, receiver est transmis comme argument this à l’appel du getter, même si celui-ci est hérité. Cela ne garantit pas que this dans le getter soit égal à receiver. Un getter lié transmet à la fonction sous-jacente la valeur à laquelle son this est lié, au lieu de l’argument this fourni à l’appel. Une fonction fléchée utilisée comme getter ignore l’argument this et utilise le this de sa portée lexicale, même si elle a été définie en mode non strict. Dans une fonction en mode non strict dont le this n’est pas lié lexicalement, un argument this valant null ou undefined est remplacé par la valeur globale de this de la fonction, et les autres valeurs primitives sont converties en objets. Le récepteur ne remplace pas target comme point de départ de la recherche. Lorsqu’une propriété de données ordinaire est lue, la valeur trouvée est renvoyée, et non une propriété de receiver.
target doit être un objet : une valeur primitive, null ou undefined provoque une TypeError, au lieu d’entraîner la conversion automatique de la valeur primitive en objet. propertyKey est converti en clé de propriété de type chaîne ou symbole. La lecture peut exécuter le code d’un getter ou le piège get d’un objet Proxy ; Reflect.get n’intercepte pas les exceptions.
Utilisez cette méthode lorsque vous devez contrôler explicitement le récepteur d’un getter. La lecture seule ne permet pas de tester l’existence d’une propriété : undefined peut signifier que la propriété est absente ou qu’il s’agit de sa valeur actuelle.
Exemples
const prototype = {
get greeting() {
return `Hello, ${this.name}`;
}
};
const target = Object.create(prototype);
target.name = "Ada";
const receiver = { name: "Lin" };
console.log(Reflect.get(target, "greeting"));
console.log(Reflect.get(target, "greeting", receiver));
console.log(Reflect.get(target, "name", receiver));
console.log(Reflect.get(target, "missing"));Résultat
Hello, Ada Hello, Lin Ada undefined
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.