CKTIS / JavaScript
WeakSet: lidmaatschap testen, waarden toevoegen en verwijderen
Met `has()` controleer je of een waarde in de verzameling zit. Met `add()` voeg je die toe en met `delete()` verwijder je die. De methoden verschillen in wat ze teruggeven en hoe ze ongeldige waarden behandelen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete is een verkorte aanduiding voor drie methoden op WeakSet.prototype, niet de naam van één methode. Roep ze aan op een instantie, zoals in seen.has(value). Een aanroep zonder WeakSet-instantie als this veroorzaakt een TypeError, ook als je de methode losmaakt van de instantie en als gewone functie aanroept.
has(value) geeft true terug als de waarde aanwezig is, anders false; de verzameling verandert niet. add(value) voegt de waarde alleen toe als die nog ontbreekt en geeft bij succes dezelfde instantie terug, zodat je aanroepen kunt aaneenschakelen. delete(value) geeft alleen true terug als er een element is verwijderd, anders false. Voor lidmaatschap telt identiteit, niet inhoud: twee afzonderlijk gemaakte objecten { id: 1 } zijn verschillende elementen.
ECMAScript 2024 staat objecten (inclusief functies) en niet-geregistreerde symbolen toe, zoals Symbol(). Symbolen uit het globale register die Symbol.for() teruggeeft en andere primitieve waarden zoals 1 en null zijn niet toegestaan. Bij een ongeldige waarde veroorzaakt add() een TypeError, terwijl has() en delete() false teruggeven. Oudere uitvoeringsomgevingen accepteren mogelijk alleen objecten; controleer of je doelomgeving symbolen ondersteunt.
Een vermelding in een WeakSet houdt een waarde op zichzelf niet in leven. Als de waarde niet meer via sterke verwijzingen bereikbaar is, kan de garbagecollector het geheugen vrijgeven; ga er niet van uit dat dit op een bepaald moment gebeurt. Een WeakSet is niet itereerbaar en heeft geen eigenschap size. Gebruik hem om al verwerkte objecten te markeren. Wil je elementen doorlopen of tellen, gebruik dan Set, dat sterke verwijzingen naar zijn elementen bewaart.
Voorbeelden
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Resultaat
true true false true false false false false true
Ook na twee keer toevoegen van `task` krijg je `seen` terug. `lookalike` heeft dezelfde inhoud, maar zit niet in de verzameling. Alleen de eerste verwijdering van `task` geeft `true` terug. De laatste `true` bevestigt het fouttype bij `add(1)`; de uitvoer hangt niet af van de garbagecollector.
Gerelateerde lessen
- JavaScript · Les 30 · Gemiddeld · Versie: 3