CKTIS / JavaScript
WeakMap : vérifier, lire et écrire des entrées avec has(), get() et set()
Vérifiez la présence d’une clé, lisez sa valeur ou modifiez-la. Apprenez à distinguer une entrée absente d’une valeur `undefined` stockée et à reconnaître les clés admises.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)WeakMap.prototype.has/get/set désigne trois méthodes d’instance de WeakMap. Les clés sont comparées par identité : deux objets distincts aux propriétés identiques constituent deux clés différentes.
has(key)renvoietruesi une entrée existe, sinonfalse.get(key)renvoie la valeur stockée, ouundefinedsi l’entrée n’existe pas. Utilisezhas(key)pour distinguer une entrée absente d’une entrée dont la valeur estundefined.set(key, value)ajoute une entrée ou remplace la valeur associée à la même clé. Cette méthode accepte toute valeur JavaScript et renvoie la même instance deWeakMap, ce qui permet de chaîner les appels.
ECMAScript 2024 admet comme clés les objets (y compris les fonctions) et les symboles non enregistrés, par exemple Symbol() et Symbol.iterator, mais pas les symboles issus de Symbol.for(). Les anciens environnements d’exécution peuvent n’accepter que les objets comme clés ; vérifiez la prise en charge des clés symboles dans l’environnement cible.
Pour une clé invalide comme 1, has() renvoie false, get() renvoie undefined et set() lève une TypeError. Les trois méthodes vérifient d’abord this : si ce n’est pas une véritable instance de WeakMap, l’appel lève une TypeError quelle que soit la clé.
Utilisez WeakMap pour associer des métadonnées à un objet sans maintenir la clé en vie, même si la valeur stockée référence cette clé. Le moment où la mémoire sera récupérée n’est pas garanti. WeakMap ne permet ni de parcourir les clés ni de consulter size ; utilisez Map si vous avez besoin de ces fonctionnalités ou de clés chaînes ou nombres.
Exemples
{
const map = new WeakMap();
const key = { id: 1 };
const lookalike = { id: 1 };
map.set(key, undefined);
console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);
const result = map.set(key, 42);
console.log(`updated: ${map.get(key)}, same map: ${result === map}`);
console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
try {
map.set(1, 42);
} catch (error) {
console.log(error.name);
}
}Résultat
stored: true, undefined missing: false, undefined updated: 42, same map: true invalid key: false, undefined TypeError
`key` et `lookalike` ont le même `id`, mais sont deux objets distincts. Les deux lectures donnent d’abord `undefined` ; seul `has(key)` renvoie `true`. La seconde écriture remplace la valeur par `42` et renvoie la même collection. La clé `1` montre la différence entre lecture et écriture pour une clé invalide.
Leçons associées
- JavaScript · Leçon 17 · Avancé · Version : 4