CKTIS / JavaScript
WeakSet — een verzameling met zwakke verwijzingen
WeakSet bevat unieke objecten en niet-geregistreerde symbolen zonder ze uitsluitend door hun lidmaatschap in leven te houden. Het biedt add, has en delete, maar laat je niet over de elementen itereren of hun aantal opvragen.
Versie: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).
Syntax
new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)WeakSet houdt waarden bij, zoals objecten die al zijn verwerkt. Objecten worden onderscheiden op basis van identiteit, niet inhoud: twee afzonderlijke objecten { id: 1 } zijn verschillende elementen. new WeakSet(iterable) voegt waarden uit het opgegeven iterable object toe; voor de constructor is new vereist.
WeakSet.prototype.add(value) voegt een element toe, negeert duplicaten en retourneert dezelfde verzameling, zodat je aanroepen kunt ketenen. WeakSet.prototype.has(value) retourneert lidmaatschap als boolean. WeakSet.prototype.delete(value) retourneert true als een bestaand element is verwijderd, en anders false.
Toegestane waarden zijn objecten, waaronder functies, en symbolen die niet via Symbol.for zijn geregistreerd. Voor niet-ondersteunde waarden, zoals getallen, tekenreeksen, null of een resultaat van Symbol.for, gooit add een TypeError, terwijl has en delete false retourneren. Ondersteuning voor symbolen is toegevoegd in ECMAScript 2023; oudere engines accepteren mogelijk alleen objecten. De taalspecificatie is geen browsercompatibiliteitstabel: controleer de ondersteuning voor deze functie in je doelomgeving.
In tegenstelling tot Set houdt WeakSet elementen niet uitsluitend door hun lidmaatschap in leven. Het tijdstip van garbage collection is niet gegarandeerd. size, iteratie, forEach en clear zijn niet beschikbaar; om lidmaatschap te controleren moet je de betreffende waarde hebben. Kies Set als je elementen moet opsommen of hun aantal wilt weten.
Voorbeelden
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));Resultaat
true false true true true false false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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