CKTIS / JavaScript
WeakSet : tester la présence et ajouter des éléments avec has() et add()
Utilisez `has()` pour savoir si une valeur appartient à un `WeakSet` et `add()` pour l’y ajouter. L’appartenance dépend de l’identité de la valeur, et la collection ne la maintient pas en vie.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has et WeakSet.prototype.add sont deux méthodes d’instance. seen.has(value) renvoie true si la valeur est présente, et false sinon. seen.add(value) ajoute la valeur si elle est absente et renvoie la même instance de WeakSet. Ajouter à nouveau la valeur ne crée pas de doublon, et la valeur de retour permet d’enchaîner les appels à add().
L’appartenance dépend de l’identité, pas du contenu : deux références au même objet désignent le même élément, mais deux objets distincts aux propriétés identiques ne correspondent pas. ECMAScript 2024 accepte les objets (y compris les fonctions) et les symboles non enregistrés, par exemple ceux créés avec Symbol(). Pour un symbole obtenu avec Symbol.for(), un nombre, une chaîne ou null, has() renvoie false et add() lève une exception TypeError. Les deux méthodes lèvent aussi une exception TypeError si this n’est pas une instance de WeakSet, par exemple si une méthode extraite est appelée sans être liée à l’instance.
L’appartenance seule n’empêche pas le ramasse-miettes de libérer la mémoire occupée par une valeur. Le moment de cette libération n’est pas prévisible. Un WeakSet n’a pas de propriété size et n’est pas itérable. Utilisez-le pour marquer les objets déjà traités si vous n’avez pas besoin de les lister par la suite. Choisissez Set si vous devez parcourir ou compter les éléments, ou stocker des valeurs comme des nombres et des chaînes.
La prise en charge des symboles peut varier selon l’environnement d’exécution. Si vous en dépendez, testez add() avec une valeur créée par Symbol() dans l’environnement cible : vérifier la présence de WeakSet ne suffit pas.
Exemples
{
const seen = new WeakSet();
const item = { id: 1 };
const alias = item;
console.log(seen.has(item));
console.log(seen.add(item).add(item) === seen);
console.log(seen.has(alias));
console.log(seen.has({ id: 1 }));
console.log(seen.has(1));
try {
seen.add(1);
} catch (error) {
console.log(error.name);
}
}Résultat
false true true false false TypeError
Le premier appel à `has()` renvoie `false`. Les deux appels à `add()` peuvent s’enchaîner car la méthode renvoie la même instance. `alias` désigne l’objet ajouté, contrairement à un nouvel objet ayant le même `id`. Pour le nombre `1`, le test renvoie `false` et l’ajout lève l’exception `TypeError` interceptée.
Leçons associées
- JavaScript · Leçon 17 · Avancé · Version : 4
- JavaScript · Leçon 43 · Avancé · Version : 4
- JavaScript · Leçon 45 · Avancé · Version : 4
- JavaScript · Leçon 40 · Intermédiaire · Version : 3