CKTIS / JavaScript
Reflect.has — vérifier si une propriété existe
`Reflect.has(target, propertyKey)` renvoie un booléen. Lorsque l’objet et tous ses prototypes sont des objets ordinaires, la méthode distingue une propriété absente d’une propriété propre ou héritée qui existe, même si sa valeur est `undefined`. Le piège `has` d’un `Proxy` peut modifier le résultat.
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.has(target, propertyKey)Reflect.has(target, propertyKey) vérifie l’existence d’une propriété, et non sa valeur. Lorsque l’objet et tous ses prototypes sont des objets ordinaires, la méthode parcourt l’objet et sa chaîne de prototypes, puis renvoie true ou false. Une propriété dont la valeur est undefined existe tout de même ; son caractère énumérable n’a aucune importance.
C’est la forme fonctionnelle de propertyKey in target. Si tu veux vérifier uniquement les propriétés propres, utilise Object.hasOwn(target, propertyKey) : contrairement à Reflect.has, cette méthode exclut les propriétés héritées.
target doit être un objet ; une valeur primitive, y compris null ou undefined, provoque une TypeError. propertyKey est converti en clé de propriété : une chaîne ou un symbole. Par exemple, le nombre 0 désigne la clé "0". Les erreurs de conversion sont propagées à l’appelant.
La méthode invoque l’opération interne [[HasProperty]]. Si la recherche rencontre un Proxy, elle peut déclencher son piège has. Ce piège peut modifier le résultat booléen : il peut signaler comme présente une propriété absente ou masquer une propriété propre configurable présente sur une cible extensible. La vérification peut aussi avoir des effets de bord ou lever une exception. Dans l’exemple, own existe malgré sa valeur undefined, tandis que inherited n’est trouvé que par la vérification qui tient compte du prototype.
Exemples
const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;
console.log(Reflect.has(item, "own"));
console.log(Reflect.has(item, "inherited"));
console.log(Reflect.has(item, "missing"));
console.log(Object.hasOwn(item, "inherited"));Résultat
true true false false
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.