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

CKTIS / JavaScript

WeakMap.prototype.get() — lire une valeur à partir de sa clé

`weakMap.get(key)` lit une valeur stockée sans modifier la collection. Utilisez `has()` 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.prototype.get est une méthode d’instance qui s’appelle sous la forme weakMap.get(key). Elle renvoie la valeur associée à la clé sans ajouter ni modifier d’entrée. Si la valeur stockée est un objet, la méthode renvoie le même objet, pas une copie.

Les clés sont comparées par identité : deux objets distincts aux propriétés identiques constituent deux clés différentes. ECMAScript 2024 accepte les objets et les symboles non enregistrés comme clés, par exemple les symboles créés avec Symbol(), mais pas ceux obtenus avec Symbol.for(). Les anciens environnements d’exécution peuvent ne pas accepter les symboles comme clés.

get() renvoie undefined si l’entrée est absente, si la clé est invalide (par exemple une chaîne) ou si la valeur stockée est undefined. weakMap.has(key) permet de distinguer une valeur undefined stockée (true) d’une entrée absente (false). Contrairement à get(), set() lève une exception TypeError si la clé est invalide. get() lève toutefois une exception TypeError si this n’est pas une instance de WeakMap, par exemple si vous stockez la méthode dans une variable et l’appelez sans la lier à la collection.

Une WeakMap ne maintient pas une clé en vie du seul fait qu’elle la stocke. Ses clés ne peuvent pas être énumérées, et on ne peut pas prévoir quand le ramasse-miettes récupérera la mémoire d’une clé devenue inaccessible.

Exemples

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

  weakMap.set(key, 42);
  weakMap.set(pending, undefined);

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

Résultat

42
undefined
undefined
true
false
undefined

`lookalike` possède les mêmes propriétés que `key`, mais c’est un autre objet. `get()` renvoie `undefined` pour `lookalike` et pour `pending`, mais `has()` ne renvoie `true` que pour `pending`. La recherche avec la chaîne `"id"` renvoie `undefined` sans lever d’exception.

Leçons associées

  • JavaScript · Leçon 35 · Débutant · Version : 4
  • JavaScript · Leçon 37 · Débutant · Version : 4
  • JavaScript · Leçon 4 · Intermédiaire · Version : 3
  • JavaScript · Leçon 10 · Intermédiaire · Version : 3

Sources