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

CKTIS / JavaScript

WeakSet : vérifier, ajouter et retirer des éléments

Utilisez `has()` pour vérifier la présence d’une valeur, `add()` pour l’ajouter et `delete()` pour la retirer. Les méthodes diffèrent par leur résultat et leur traitement des valeurs non autorisées.

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

Syntaxe

weakSet.has(value)    // boolean
weakSet.add(value)    // the same WeakSet instance
weakSet.delete(value) // boolean

WeakSet.prototype.has/add/delete désigne trois méthodes de WeakSet.prototype, et non une seule méthode. Appelez-les sur une instance, par exemple avec seen.has(value). Un appel sans instance de WeakSet comme this déclenche une TypeError, notamment si vous détachez la méthode et l’appelez comme une fonction ordinaire.

has(value) renvoie true si la valeur est présente et false sinon, sans modifier l’ensemble. add(value) ajoute la valeur seulement si elle est absente et renvoie, en cas de succès, la même instance, ce qui permet de chaîner les appels. delete(value) ne renvoie true que si un élément a été retiré ; sinon, la méthode renvoie false. L’appartenance dépend de l’identité, pas du contenu : deux objets { id: 1 } créés séparément sont des éléments distincts.

ECMAScript 2024 accepte les objets (y compris les fonctions) et les symboles non enregistrés, comme Symbol(). Les symboles du registre global renvoyés par Symbol.for() et les autres valeurs primitives, telles que 1 et null, ne sont pas admis. Pour une valeur non autorisée, add() déclenche une TypeError, tandis que has() et delete() renvoient false. Les anciens environnements d’exécution peuvent n’accepter que les objets ; vérifiez la prise en charge des symboles dans l’environnement cible.

Une entrée dans un WeakSet ne suffit pas à maintenir une valeur en vie. Si la valeur n’est plus accessible par des références fortes, le ramasse-miettes peut la récupérer ; ne comptez pas sur le moment où cela se produit. Un WeakSet n’est pas itérable et n’a pas de propriété size. Utilisez-le pour marquer des objets déjà traités ; si vous devez parcourir ou compter les éléments, utilisez Set, qui conserve des références fortes vers ses éléments.

Exemples

{
  const seen = new WeakSet();
  const task = { id: 1 };
  const lookalike = { id: 1 };

  console.log(seen.add(task).add(task) === seen);
  console.log(seen.has(task));
  console.log(seen.has(lookalike));
  console.log(seen.delete(task));
  console.log(seen.delete(task));
  console.log(seen.has(task));
  console.log(seen.has(1));
  console.log(seen.delete(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Résultat

true
true
false
true
false
false
false
false
true

Même après deux ajouts de `task`, la valeur renvoyée est `seen`. `lookalike` a le même contenu mais n’est pas membre de l’ensemble. Seul le premier retrait de `task` renvoie `true`. Le dernier `true` confirme le type d’erreur de `add(1)` ; le résultat ne dépend pas du ramasse-miettes.

Leçons associées

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

Sources