CKTIS / JavaScript
WeakSet — un ensemble à références faibles
WeakSet contient des objets uniques et des symboles non enregistrés sans les maintenir en vie du seul fait de leur appartenance à l’ensemble. Il propose add, has et delete, mais ne permet ni d’itérer sur ses éléments ni d’en lire le nombre.
Version : WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).
Syntaxe
new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)WeakSet sert à suivre des valeurs, par exemple des objets déjà traités. Les objets sont distingués par leur identité, et non par leur contenu : deux objets distincts { id: 1 } sont des éléments différents. new WeakSet(iterable) ajoute les valeurs de l’itérable fourni ; le constructeur nécessite new.
WeakSet.prototype.add(value) ajoute un élément, ignore les doublons et renvoie le même ensemble, ce qui permet d’enchaîner les appels. WeakSet.prototype.has(value) renvoie l’appartenance sous forme de boolean. WeakSet.prototype.delete(value) renvoie true si un élément existant a été supprimé, et false dans le cas contraire.
Les valeurs autorisées sont les objets, y compris les fonctions, ainsi que les symboles qui ne sont pas enregistrés avec Symbol.for. Pour les valeurs non prises en charge, comme les nombres, les chaînes, null ou le résultat de Symbol.for, add déclenche une TypeError, tandis que has et delete renvoient false. La prise en charge des symboles a été ajoutée dans ECMAScript 2023 ; les moteurs plus anciens peuvent n’accepter que les objets. La spécification du langage n’est pas un tableau de compatibilité des navigateurs : vérifiez la prise en charge de cette fonctionnalité dans votre environnement cible.
Contrairement à Set, WeakSet ne maintient pas les éléments en vie du seul fait de leur appartenance. Le moment du ramasse-miettes n’est pas garanti. Il n’existe ni size, ni itération, ni forEach, ni clear ; pour vérifier l’appartenance, vous devez détenir la valeur concernée. Choisissez Set si vous devez énumérer les éléments ou connaître leur nombre.
Exemples
const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);
console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));Résultat
true false true true true false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262