KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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