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