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

CKTIS / JavaScript

WeakMap.get() — lire une valeur à partir d’une clé

`weakMap.get(key)` renvoie la valeur associée à une clé. Utilisez `has(key)` pour distinguer une entrée absente d’une entrée dont la valeur est `undefined`.

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

Syntaxe

weakMap.get(key)

WeakMap.get est un nom abrégé de la méthode d’instance WeakMap.prototype.get, et non une méthode statique du constructeur. weakMap.get(key) lit la valeur enregistrée sans modifier la collection. Les clés sont comparées par identité : deux objets créés séparément avec les mêmes propriétés sont des clés différentes. Si la valeur enregistrée est un objet, get() renvoie ce même objet, pas une copie.

Une entrée absente et une entrée dont la valeur est undefined donnent toutes deux undefined. Pour les distinguer, utilisez weakMap.has(key) : la méthode renvoie true quand l’entrée existe, même si sa valeur est undefined.

ECMAScript 2024 accepte comme clés les objets, fonctions comprises, et les symboles non enregistrés tels que Symbol('id'). Des moteurs plus anciens peuvent prendre en charge WeakMap sans accepter les symboles comme clés. Sur une instance de WeakMap, get() renvoie undefined pour une clé invalide, telle qu’une chaîne ou un symbole renvoyé par Symbol.for(), alors que set() lève une TypeError. get() lève elle-même une TypeError si son this n’est pas une instance de WeakMap, par exemple si vous appelez la méthode séparément sans la lier à une instance.

La collection ne maintient pas à elle seule une clé en vie. Quand la clé n’est plus accessible, son entrée peut être supprimée lors du ramasse-miettes. On ne peut pas énumérer les clés ni compter sur la suppression d’une entrée à un moment précis.

Exemples

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

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Résultat

42
undefined
undefined
true
undefined

`key` et `otherKey` sont deux objets distincts malgré leurs propriétés identiques. Les deux lectures avec `otherKey` renvoient `undefined` : d’abord l’entrée est absente, puis elle existe avec la valeur `undefined`, ce que confirme `has()`. La dernière lecture utilise une clé invalide.

Leçons associées

  • JavaScript · Leçon 18 · Débutant · Version : 4

Sources