CKTIS / JavaScript
WeakSet — eine Menge mit schwachen Referenzen
WeakSet enthält eindeutige Objekte und nicht registrierte Symbole, ohne sie allein durch ihre Zugehörigkeit am Leben zu halten. Es bietet add, has und delete, erlaubt aber weder die Iteration über Elemente noch das Auslesen ihrer Anzahl.
Version: 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 dient dazu, Werte nachzuverfolgen, etwa bereits verarbeitete Objekte. Objekte werden anhand ihrer Identität und nicht ihres Inhalts unterschieden: Zwei separate Objekte { id: 1 } sind verschiedene Elemente. new WeakSet(iterable) fügt Werte aus dem übergebenen iterierbaren Objekt hinzu; der Konstruktor erfordert new.
WeakSet.prototype.add(value) fügt ein Element hinzu, ignoriert Duplikate und gibt dieselbe Menge zurück, sodass sich Aufrufe verketten lassen. WeakSet.prototype.has(value) gibt die Zugehörigkeit als boolean zurück. WeakSet.prototype.delete(value) gibt true zurück, wenn ein vorhandenes Element entfernt wurde, andernfalls false.
Zulässig sind Objekte, einschließlich Funktionen, sowie Symbole, die nicht über Symbol.for registriert wurden. Bei unzulässigen Werten wie Zahlen, Zeichenketten, null oder einem Ergebnis von Symbol.for löst add einen TypeError aus, während has und delete false zurückgeben. Die Unterstützung für Symbole wurde mit ECMAScript 2023 hinzugefügt; ältere Engines akzeptieren möglicherweise nur Objekte. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle: Prüfe die Unterstützung dieser Funktion in deiner Zielumgebung.
Anders als Set hält WeakSet Elemente nicht allein durch ihre Zugehörigkeit am Leben. Für die Garbage Collection gibt es keinen garantierten Zeitpunkt. size, Iteration, forEach und clear sind nicht verfügbar; für eine Mitgliedschaftsprüfung musst du den geprüften Wert besitzen. Wähle Set, wenn du Elemente aufzählen oder ihre Anzahl kennen musst.
Beispiele
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));Ergebnis
true false true true true false false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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