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

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