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

CKTIS / JavaScript

Opérateur in — vérifier l’existence d’une propriété

L’opérateur `in` vérifie la présence d’une propriété à partir de sa clé, sans examiner sa valeur. Pour un objet ordinaire dont la chaîne de prototypes ne contient que des objets ordinaires, il tient compte des propriétés propres et héritées. Le piège `has` d’un `Proxy` peut modifier le résultat. L’opérande de droite doit être un objet ; une valeur primitive provoque une `TypeError`.

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

propertyKey in object
#privateName in object

Si l’objet et tous les objets de sa chaîne de prototypes sont des objets ordinaires, propertyKey in object renvoie true pour une propriété propre ou héritée, et false sinon. L’opérande de gauche est converti en clé de propriété : une chaîne de caractères ou un Symbol. L’opérande de droite doit être un objet ; null, undefined et les chaînes primitives provoquent également une TypeError.

Le piège has d’un Proxy peut intercepter la vérification de la clé, y compris lors de la recherche dans la chaîne de prototypes. Il peut par exemple signaler qu’une clé est présente alors qu’elle est absente de la cible et de ses prototypes, ou masquer une propriété propre configurable qui existe sur une cible extensible.

L’existence ne signifie pas que la valeur soit différente de undefined : une propriété ayant cette valeur existe tout de même. Pour vérifier uniquement les propriétés propres, utilisez Object.hasOwn(object, propertyKey). L’opérateur in inclut aussi les propriétés non énumérables ; ce n’est pas une boucle for...in.

Pour les tableaux, in vérifie les clés d’index, et non la présence d’une valeur. Un trou laissé par delete n’est pas un élément propre au tableau, même si son index est inférieur à length. Si aucun Proxy n’intercepte la vérification et que la recherche ne trouve pas non plus la clé dans la chaîne de prototypes, le résultat est false.

La syntaxe distincte #privateName in object vérifie la présence d’un élément privé précis, et non d’une propriété dont la clé est une chaîne de caractères. Le nom privé doit être déclaré dans une portée de classe englobante ; l’opérande de droite doit toujours être un objet.

Exemples

const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;

console.log("own" in item);
console.log("inherited" in item);
console.log("missing" in item);
console.log(Object.hasOwn(item, "inherited"));

const values = [undefined];
console.log(0 in values);
delete values[0];
console.log(0 in values);

Résultat

true
true
false
false
true
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.

Sources