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

CKTIS / JavaScript

WeakMap.prototype.has() : vérifier la présence d’une clé

`weakMap.has(key)` vérifie si la collection contient une entrée pour cette clé, même si la valeur stockée est `undefined`.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

weakMap.has(key)

WeakMap.prototype.has est une méthode d’instance, pas une méthode statique. L’appel weakMap.has(key) renvoie true si cette collection contient une entrée pour la clé, et false sinon. Il ne modifie pas la collection. Les clés sont comparées par identité : deux objets distincts ayant les mêmes propriétés constituent deux clés différentes.

Utilisez has() pour distinguer une entrée absente d’une entrée dont la valeur est undefined. Dans les deux cas, get() renvoie undefined.

ECMAScript 2024 autorise comme clés les objets (y compris les fonctions) et les symboles non enregistrés comme Symbol('id'). Les anciens environnements d’exécution peuvent n’accepter que des objets comme clés. Pour une clé non valide, comme une chaîne de caractères ou un symbole issu de Symbol.for('id'), has() renvoie false, tandis que set() lève une exception TypeError.

Une valeur non valide pour this est un autre cas : la méthode exige une instance de WeakMap comme this. Ainsi, const has = weakMap.has; has(key); lève une exception TypeError au lieu de renvoyer false.

Une entrée dans un WeakMap n’empêche pas à elle seule le ramasse-miettes de récupérer la mémoire occupée par sa clé. has() exige que vous fournissiez la clé ; cette méthode ne permet ni de lister les clés ni de savoir quand le ramasse-miettes est intervenu.

Exemples

{
  const weakMap = new WeakMap();
  const key = { id: 1 };
  const otherKey = { id: 1 };

  weakMap.set(key, undefined);

  console.log(weakMap.has(key));
  console.log(weakMap.get(key));
  console.log(weakMap.has(otherKey));
  console.log(weakMap.get(otherKey));
  console.log(weakMap.has("id"));
}

Résultat

true
undefined
false
undefined
false

Les deux appels à `get()` renvoient `undefined`, mais seul `has(key)` renvoie `true`. `otherKey` a les mêmes propriétés, mais c’est un autre objet, et la chaîne `"id"` n’est pas une clé valide.

Leçons associées

  • JavaScript · Leçon 10 · Intermédiaire · Version : 3

Sources